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Special Notices 



Programming Interfaces 



This book is intended to help system programmers customize the NetView 
program. It contains descriptions of the parts of the NetView program that can 
be customized, and provides pointers to sources of background information. 
This book documents no programming interface for use by customers in writing 
programs that request or receive the services of NetView, except as noted 
below. 

This book also documents general-use programming interface information and 
associated guidance information. 

General-use programming interfaces allow the customer to write application 
programs that request or receive the services of NetView. 

General-use programming interface information is explicitly identified where it 
occurs, either by an introductory statement to a chapter or section that is 
entirely general-use programming interface information, or by the following 
marking: 



General-Use Programming Interface Information 



Description of general-use programming interface information.... 
I End of General-Use Programming Interface Information 



Product-sensitive programming interfaces are provided to allow the customer 
installation to perform tasks such as tailoring, monitoring, modification, or diag- 
nosis of this IBM product. Use of such interfaces creates dependencies on the 
detailed design or implementation of the IBM product. Product-sensitive inter- 
faces should be used oniy for these specialized purposes. Because of their 
dependencies on detailed design and implementation, it is to be expected that 
programs written to such interfaces may need to be changed in order to fun with 
new product releases or versions, or as a result of service. 

Product-sensitive programming interface information is explicitly identified 
where Jt occurs, either by an introductory statement to a chapter or section that 
is entirely product-sensitive programming interface information, or by the fol- 
lowing marking: 



I Product-Sensitive Programming Interface Information 

Description of product-sensitive programming interface information.... 
I End of Product-Sensitive Programming interface Information 



The licensed program described in this document and all licensed materia! avail- 
able for it are provided by IBM under terms of the Agreement for IBM Licensed Pro- 
grams. Changes are made periodically to th® information herein; before you us© 
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this document in connection with the operation of IBM systems, consult the latest 
IBM System/370, 30XX, 4300, and 9370 Processors Bibliography, GC20-0001, for the 
editions that are applicable and current. 

Any reference to an IBM licensed program in this document is not intended to state 
or imply that only IBM's program may be used. 

IBM may have patents or pending patent applications covering subject matter 
described in this document. The furnishing of this document does not give you any 
license to these patents. You can send inquiries, in writing, to the IBM Director of 
Commercial Relations, International Business Machines Corporation, Purchase, 
New York, 10577. 

References in this publication to IBM products, programs, or services do not imply 
that IBM intends to make them available in ail countries in which IBM operates. 

This document is not intended for production use and is furnished as is without any 
warranty of any kind, and all warranties are hereby disclaimed including the war- 
ranties of merchantability and fitness for a particular purpose. 

Some trademarks of the IBM Corporation in the United States and/or other countries 
appear in this document. These IBM trademarks are: 

IBM MVS/ESA MVS/XA NetView 

VM/XA VTAM 
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About This Book 



This book is intended to help system programmers customize the NetView 
program. It describes the parts of the NetView program that can be customized and 
provides pointers to sources of background information. 

Use this book after you have installed the NetView program and discovered that a 
function or task needs to be created or modified for your use. You may need to 
create or modify panels, or write a user exit routine, command processor, command 
list, or subtask. This book contains procedures and examples to help you modify 
panels and develop your own programming enhancements. 

To make full use of this guide, you need to understand how certain terms are used 
and where to find detailed information about those terms. 



Trademark of the IBM Corporation— see "Special Notices" on page iii for a list of IBM trademarks used in this book. 
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Terms Used in This Book 

VTAM* 



ACF/VTAM, V3R2, V3R3 

MVS 

MVS/XA*. MVS/ESA* 

VM 

VM/SP, VM/SP HPO, VM/XA* (in compatibility mode). 

Command List 

A list of commands and statements designed to perform a specific function 
for the user. Command lists can be written in REXX or in NetView command 
list language. 

Command Procedure 

Either a command processor written in a high-level language (HLL) or a 
command list. See command processor and command list for further expla- 
nation. 

Command Processor 

A user-written module designed to perform a specific function. Command 
processors, which can be written in assembler or a high-level language 
(HLL), are invoked as commands. 

Component 

A command that (a) controls the terminal' s screen (using the DSIPSS macro 
(TYPE = ASYPANEL) or the VIEW command), (b) allows the operator to enter 
NetView commands, and (c) can resume when such commands are com- 
plete. 

High-Level Language (HLL) 

A programming language that does not reflect the structure of any particular 
computer or operating system. For NetView Release 3, the high-level lan- 
guages are PL/I and C. 

NetView Command List Language 

An interpretive language unique to the NetView program that is used to 
write command lists. 

NAM 

Network Asset Management. An automated and tailorable means of col- 
lecting data from network resources for inventory and asset management. 

REXX 

Restructured Extended Executor Language. An interpretive language used 
to write command lists. 

User Exit Routine 

A user-written routine that receives control at predefined user exit points. 
User exit routines can be written in assembler or a high-level language 
(HLL). 

VPD 

Vital product data. Product identification information such as machine type, 
model number, and serial number for hardware products. For software pro- 
ducts, vital product data can be version and release level. 



Trademark of the IBM Corporation— see "Special Notices" on page iii for a list of IBM trademarks used in this book. 
Xii Customization Guide 



Customization Areas 



This section discusses the areas of the NetView program that can be customized. 
Since customization of the NetView program takes place at various stages of 
network and system implementation, these topics are discussed in several different 
manuals. Table 1 on page xv indicates which NetView manuals contain more infor- 
mation on the listed topics. 

Alias names are used to communicate across networks. You can use alias names 
to resolve duplicate resource names. With alias names, the name of the resource 
(such as a logical unit (LU), a class of service, a source LU (SRCLU), or a LOGON 
mode table) from the sending network is translated to a name that is unique to the 
receiving network. See NetView Installation and Administration Guide for more 
information on how to define alias names. 

Filtering controls the amount of data presented to operators. It also controls the 
amount of data recorded. Message filtering using IF-THEN statements in the 
message automation table allows you to control the types of messages each of your 
network operators will receive. NetView Installation and Administration Guide dis- 
cusses how to use automation statements to filter messages. IF-THEN statements 
are discussed in NetView Administration Reference. 

Filtering can also be done on event data sent by network resources to the hardware 
monitor. Recording filters control which information is recorded into the hardware 
monitor's data base. Once data has been recorded, viewing filters can be set to 
determine which records will appear on each network operator's terminal. More 
information on hardware monitor filtering can be found in NetView Operation. 

Generic alerts and code points are used to obtain problem determination support for 
devices and applications in your network that the NetView program does not auto- 
matically support. Chapter 4, "Customizing Hardware Monitor Displayed Data" on 
page 45 in this book contains details on how to use the IBM-supplied and 
user-defined code point tables to build hardware monitor Alerts-Dynamic, 
Alerts-Static, Alerts-History, Event Detail, and Most Recent Events screens. 

You can use automated operations to implement automatic responses to events that 
occur in your network. NetView Installation and Administration Guide and NetView 
Administration Reference provide a more detailed explanation of how to define 
if-then message automation statements to improve the productivity of your 
system/network operators. More detailed information on when and how to use the 
NetView program's automated operations can be found in Console Automation 
Using NetView Planning and Console Automation Using NetView Implementing. 

National Language Support (NLS) will allow your operators to interact with the 
NetView program in a language other than English. The NetView Installation and 
Administration Guide explains how to write your own message translations in any 
language you prefer. The NetView program also offers a Kanji feature which sup- 
plies you with pre-translated panels and messages in Japanese using the Kanji 
character set. NetView Installation and Administration Guide discusses how to 
install the Kanji feature. 

You may need to consider operator control and security. To control who can gain 
access to the NetView program and what effect an operator can have on your 
network, you should consider some level of logon verification, scope of commands, 
and span of control. NetView Installation and Administration Guide discusses how 
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to implement the different levels of security verification available in the NetView 
program. It also discusses how to limit which commands an operator can issue 
(scope of commands) and which part of the network's resources an operator can 
control (span of control). 

You can create or change panels for your online help, online message help, help 
desk facility, the hardware monitor, and any user-written, full-screen applications. 
For a detailed explanation of how to create new panels or modify IBM-supplied 
panels for these components, refer to Part 2 of this book. 

Sequential logging (Sequential Access Method Log support) allows you to write vari- 
able length records to multiple user-defined logs. These logs can be browsed or 
printed using your operating system facilities. Further explanation of how to define 
sequential log tasks can be found in NetView Installation and Administration Guide, 
NetView Customization: Using Assembler and NetView Customization: Using PL/I 
andC. 

Session monitor data can be collected and kept in the session monitor data base. 
To control how much session data is collected and kept, you need to customize 
several session monitor definition statements. NetView Installation and Adminis- 
tration Guide explains how to change these definitions to fit the needs of your instal- 
lation. Defining performance classes for the response time monitor (RTM) feature is 
also covered in NetView Installation and Administration Guide. Objectives and 
boundaries are set for each performance class and then a performance class is 
chosen for a session. 

User-written functions add new functions to the NetView program or modify existing 
ones. You may want to develop your own command lists and user-written code. 
NetView Customization: Writing Command Lists discusses how to write command 
lists in REXX or in NetView command list language to help you control your network 
and make the operators' jobs easier. Information on how to write user-written code 
such as command processors and user exits in PL/l and C can be found in NetView 
Customization: Using PL/I and C. Information on writing command processors, user 
exit routines, and user subtasks in assembler language can be found in NetView 
Customization: Using Assembler. 



Following is a list of the abbreviations and documentation names used in Table 1 on 
page xv. 

Customization Guide 

Installation and Administration Guide 

Operation 

Customization: Writing Command Lists 

Customization: Using PL/I and C 

Customization: Using Assembler 

Automation Using NetView: Implementing 

Automation Using NetView: Planning 



Guide 


NetView 


Install 


NetView 


Op 


NetView 


CL 


NetView 


PL/I.C 


NetView 


A 


NetView 


CA 


Console 




Console 
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Table 1. Customization Topics and Documentation 



Topic 


Guide 


Install 


Op 


CL 


PL/I, C 


A 


CA 


Alias Names 




V 












Automated Operations 




V 










J 


Filtering: 

Message 

Hardware Monitor Filters 




V 


V 








~ 


Generic Alerts 


V 














National Language Support 




V 













Operator Control: 
Logon Security 
Scope of Commands 
Span of Control 






Panels: 

Hardware Monitor 
Help 

Help Desk 
User-written 



V 



Sequential Logging 



V 



V 



V 



V 



Session Monitor Data: 
Response Time Monitor 
Session Awareness 



User-Written Functions: 
Command Lists 

(REXX, NetView) 
User-Written Programming 

(PL/I, C) 
User-Written Programming 

(Assembler) 



V 



V 



V 



What Is New in This Book 



Only minor changes have been made in this book. The changes include the addition 
of two small appendixes and a few other changes. The changes are identified by 
vertical lines in the left margins of pages where the changes appear. 
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Where to Find More Information 



The following list shows all of the publications in the NetView Release 3 library, 
arranged according to related tasks. For more information on these and other 
related publications, see "Bibliography" on page 109. 

Evaluation and Education 

Network Program Products General Information GC30-3350 

Bibliography and Master Index for NetView, NCP, and VTAM GC31-6095 

Learning about NetView: Operator Training (PC Diskettes) SK2T-0292 



Planning 

Planning and Reference for Netview, NCP, and VTAM 
NetView Storage Estimates (PC Diskettes) 
Console Automation Using NetView: Planning 



SC31-6811 
SK2T-1988 
SC31-6058 



Installation and Administration 

NetView Installation and Administration Guide 
NetView Administration Reference 
Network Program Products Samples 
NetView Tuning Guide 



SC31-6018 
SC31-6014 
SC30-3352 
SC31-6079 



Customization 

NetView Customization Guide 
NetView Customization: Writing Command Lists 
NetView Customization: Using PL/I and C 
NetView Customization: Using Assembler 
Console Automation Using NetView: Implementing 



SC31-6016 
SC31-6015 
SC31-6037 
SC31-6078 
LY43-0007 



Operation 

NetView Operation Primer 
NetView Operation 
NetView Command Summary 



SC31-6020 
SC31-6019 
SX75-0026 



Application Programming 

NetView Application Programming Guide: Program-to- 
Program Interface 



SC31-6093 



Diagnosis 

NetView Problem Determination and Diagnosis LY43-0001 

NetView Resource Alerts Reference SC31-6024 

NetView Problem Determination Supplement for LD2 1-0023 

Management Services Major Vectors 0001 and 0025 
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Chapter 1. Designing and Implementing Your Own Functions 

This chapter tells you what you need to know before making an addition or change 
to the NetView program, and lists some of the facilities available to help you cus- 
tomize tasks. 

To customize NetView functions, you can add your own or modify the existing 
NetView program. Modifying existing functions include: 

• Filtering or modifying the system management facility (smf) records that the 
NetView program writes 

• Providing your own policy to route operator messages 

• Reformatting, analyzing, or compressing operator messages 

• Checking command authority. 

Additional function you may want to add could involve managing additional compo- 
nents in your network, such as X.25 data network components or voice network com- 
ponents. You can develop new applications and integrate them with the NetView 
program 's existing management functions to meet your installation requirements. 
Examples of these user-defined functions might include: 

• Real-time monitoring of specific resources, applications, or components in your 
network 

• Collecting and recording additional SMF data for trend analysis or other data 
reduction applications you need 

• Providing additional response time problem detection and alerting 

• Detecting different classes of line problems and providing switched network 
backup (SNBU). 

One approach to developing and implementing your own functions in the NetView 
program could be to: 

1. Define your objectives by clearly expressing which changes or additional func- 
tions you need. 

2. Understand how the new functions are to be used, and how they are to be pro- 
vided. 

3. Identify concepts and facilities in the NetView program that you can use to 
implement your functions. 

4. Map your implementation into the NetView task structure. 

5. Define transactions that implement your functions within tasks. 
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Defining Objectives 



The first step in the design process is to understand the problem you are trying to 
solve. You may need to present new data to operators, change the way information 
is being presented, or provide another way to request information. To respond to 
such needs, you must decide which new operator commands are required, and the 
format you want to use to present new information. You may need to eliminate 
certain operator commands or actions thereby reducing the amount of information 
your operators must handle. 

For some problems, you might focus more on data collection, data analysis, and 
data recording than on operator actions. Your objective may be to describe which 
network and data processing components are involved in input and output (I/O), and 
what processing is to be done on the data. 

When you have clearly stated your problem and determined specific objectives for 
addressing it, you have in fact defined the solution as well. 



Usage Scenarios 



When you understand the problem and its solution, you should review the problem 
with the people who will be using your solution. Be sure the results you are trying 
to obtain match the needs of those whose problem you are trying to solve. You can 
adjust your solution, or you can gain a new understanding of the problem that may 
suggest a better solution. The more detail you can develop at this stage, the better. 
You should understand all the input needed, all the output to be produced, and ail 
the steps required to collect, process, and record. 



Identifying Conceptual Components 



The functions required to support your usage scenario will be implemented within 
the components of the NetView program. You will need facilities to: 

• Gather data on what is happening in your system and network 

• Store and record some of this data 

• Present data to NetView operators or to other programs. 

Collecting Data 

Typical sources available for collecting data that is useful in customization are: 

• User exit interfaces provided in the NetView program. 

• System or NetView services that provide status, configuration, processing, or 
authorization information. 



• 



Data files and network devices that can be accessed using system or NetView 
services. 



• Messages to operators that indicate important events are occurring in a system 
or an application. 
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User Exits 



Service Routines 



Some of the NetView program 's exits allow access to network management data. 
Through these exits, user-written functions can obtain the text of operator com- 
mands, messages, and logons. Data that the NetView program writes to VSAM files 
and to the SMF log, as well as data on the VTAM CNMI, can be accessed within other 
NetView exits. Refer to NetView Customization: Using Assembler and NetView 
Customization: Using PL/I and C for more information on these user exits. 



System or NetView services give you access to information such as the system date 
and time, the addresses of programs, the addresses of named storage areas, oper- 
ator span of control and scope of authority, and the values of command list vari- 
ables. Refer to NetView Customization: Using Assembler for information on 
DSIDATIM, DSICES, DSIFIND, DSISSS, and DSIKVS. Refer to NetView Customization: 
Using PL/I and C for information on CNMINFC, CNMNAMS, CNMSCOP, and CNMVARS. 



Data Files 



The NetView program provides specialized disk services and VSAM data services to 
access network management data files. In addition to these, functions written in 
high-level language (HLL) may invoke system allocation and access methods to read 
and write data. CNMI services also provide access to data coming from devices in 
the network. Refer to NetView Customization: Using Assembler for information on 
DSIDKS, DSIZVSMS, DSIZCSMS. Refer to NetView Customization: Using PL/I and C for 
information on HLL VSAM and CNMI services. Refer to NetView Customization: 
Writing Command Lists for information on REXX file I/O. 

Operator Commands and Messages 

Operator commands can be issued within command procedures to request status 
data. The resulting response messages containing the requested status data can 
then be trapped and processed in the command procedure. Data in other system 
and network messages can also be processed in user-written command procedures 
that can be invoked through NetView message automation. Refer to NetView 
Customization: Writing Command Lists for information on REXX and NetView 
command list language message processing. Refer to NetView Customization: 
Using PL/I and C for information on HLL message processing. 

Data Storage and Recording 

NetView command list variables can be used to store and retrieve data needed for 
many user-written functions. Command procedures written in REXX, NetView 
command list language, PL/l, or C may create, set, and read command list variables. 

For permanent storage and for larger volumes of data, you may want to record 
certain information in data files rather than simply naming it and storing it as a 
command list variable. The NetView program provides logging facilities for 
recording this data in a log. For example, you may find it useful to log activities of 
your own applications along with system or network activities that the NetView 
program is logging. In other cases, you may want to produce a separate log of your 
own for data that you collect. Refer to NetView Installation and Administration 
Guide and "Choosing an Application Program Interface" on page 9 in this book for 
information on sequential logging. 
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Operator Presentation 

Some of the NetView program ' s operator presentation functions can be customized 
or extended by using the VIEW command or by modifying panels that are used by 
some components of the NetView program to present data to operators. Refer to 
Chapter 2, "Using the VIEW Command" on page 13 and Chapter 3, "Modifying and 
Creating Online Panel Interfaces" on page 35 for more information on these topics. 

You can also use messages as a means to present information to operators. By 
presenting data from user-written functions in the form of messages, the data 
becomes subject to message automation processing, allowing both automatic and 
manual operation of your functions. Refer to NetView Customization: Using Assem- 
bler for DSIWCS, DSIMBS, DSIMQS, DSIPSS, and other message services. Refer to 
NetView Customization: Using PUI and C for CNMSMSG. Refer to NetView 
Customization: Writing Command Lists for REXX and NetView command list lan- 
guage write-to-operator (WTO) messages and other message services. 

Task Structure 

In order to write your own functional extensions to the NetView program, it is neces- 
sary to first understand how the NetView program operates. The NetView 
program 's design is based on MVS system concepts and facilities. In a VM system 
environment, the guest operating system group control system (GCS) is used to sim- 
ulate MVS system services for both VTAM and the NetView program. MVS/XA 
Supervisor Services and Macros is a good reference for further explanation of how 
words such as dispatch, task, and the names of various system services are used in 
this discussion. 

The NetView Program as a System Application Program 

First consider how the NetView program looks to the operating systems that support 
it. The NetView program is organized into several tasks running in parallel, each 
one separately dispatchable in a multitasking environment. When any one task is 
idle, any of the others are eligible to run. A system multitasking dispatcher is used 
to accomplish this by using the NetView program 's ATTACH system service to 
create each new task. The WAIT system service is invoked by each NetView task 
when it has no more processing work to do and is ready to become idle. The POST 
system service is used to take any task out of an idle state and make it dispatchable 
when that task has new input data ready to be processed. 

The NetView Program Tasks 

When the NetView program starts, its main task attaches several subtasks of dif- 
ferent types depending on the function that each is to perform and on the name of 
the program that each task runs when it starts. Each different task type determines 
the specific system interfaces and operator interfaces that are available under that 
task, and the type of transactions that may be performed under the task. 

Each operator station task (OST) supports one NetView operator identified by a 
unique name. The operator identifiers (OPlDs) are defined in the NetView parameter 
library and are assigned to an OST when an automated operator,, known as an 
autotask, is activated using the AUTOTASK command, or when an operator logs on 
using a VTAM connected terminal. The program module DSIOST runs for every OST. 

Each NetView- NetView task (NNT) also supports an operator. This type of task is 
used when the operator logs on to the NetView program from another NetView 
program instead of from a terminal. The other NetView program may be running in 
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a different machine but must be connected through VTAM. The operator logs on 
from the other NetView program using the START DOMAIN command; The program 
module DSIOST also runs for every NNT. 

Each hardcopy task (HCT) supports a 3287 printer connected through VTAM to 
provide a hardcopy log for one or more operators. 

There is only one primary programmed operator interface (POI) task (PPT) for each 
NetView program, and it runs the program module DSIPPT. The PPT provides time 
interval notification for all NetView tasks. When VTAM is running, the PPT opens a 
special VTAM application control block (ACB) for the VTAM programmable operator 
interface (POI) to receive unsolicited data from VTAM. 

Each optional task (OPT) must be defined by a TASK statement in the NetView 
parameter library. The program module that runs for an OPT may be any program 
that meets the specification for optional tasks described in "Adding Optional Tasks 
to the NetView Program" on page 8. 

Each data services task (DST) is a specific case of an optional task whose program 
module is DSIZDST. (See "Adding Optional Tasks to the NetView Program" on 
page 8.) The TASK statement for a DST may name an initialization member in the 
NetView parameter library from which statements are read to define parameters for 
the functions performed by the specified DST. 

Program Activity within a Task 

All the NetView tasks discussed in "The NetView Program Tasks" on page 4 share a 
common program design. They are all designed to WAIT once they have been 
started until they receive a POST that causes them to be dispatched to perform a 
specific unit of work. When that work is complete, the WAIT macro is issued again 
and the task continues running only if and when another POST has been done for 
another unit of work. All these tasks use a list of event control blocks (ECB) when 
they issue their WAIT. The NetView customization macros and services are pro- 
vided to ensure that any implied waiting is done through the task's ECB list so that 
all of the NetView program's task-request interfaces remain enabled. 

Every NetView task has its own termination ECB and its own message queue ECB. 
Depending on the type of task, (OST, DST, etc.) there may be additional ECBs in a 
task's ECB list that represent different kinds of processing that the task has been 
designed to test for and perform when it is POSTed out of its WAIT state. 

Queuing Work to NetView Program Tasks 

While any one task is in its normal WAIT state, any of the other tasks in the NetView 
program may be running. In fact, even a running NetView task may at any time be 
interrupted due to an event in the system, and may be preempted by a higher pri- 
ority task until that task issues its normal WAIT. System functions outside of the 
NetView program may also interrupt the NetView program processing by scheduling 
interrupt exit routines to run that are associated with specific NetView tasks. 

As a result, a task may have data placed in its message queue or another work 
queue that it is designed to support, and it may be POSTed to perform that work at 
any time. The data may have originated in another NetView task. This commonly 
happens when a DST queues message data to an OST to be displayed to an oper- 
ator. The data may have come into the NetView program through an interrupt exit 
routine which was scheduled by an event such as a VTAM RECEIVE request being 
completed from a NetView operator's terminal. This is how the text of an operator 
command is given to an OST to be processed. 
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Message and Command Buffers 

The data placed in the various task queues is formatted into a special data structure 
commonly referred to as a message buffer or buffer. A buffer header at the begin- 
ning of the buffer indicates the type of data that it contains and any special formats 
by which the data must be accessed. Commands are processed by programs called 
command processors which you provide as a part of your customization program- 
ming for the NetView program. Messages are processed either according to prede- 
fined processing built into the NetView task, or by message automation command 
processors. Where a message or other data in the NetView program is not handled 
in the command processor interface, your customization programming may provide 
user exit routines to determine some of the processing that is performed on this 
data. 

Immediate Commands 

An immediate command starts processing as soon as an operator enters the 
command, regardless of any regular command currently running. Thus the 
requested function is performed at once, even if the task is in the middle of a large 
queue of work. 

An immediate command runs under the OST (operator station task) and NNT 
(NetView- NetView) subtask environments. Unlike other commands, immediate 
commands receive control with the TVBINXIT bit set on. This means that they inter- 
rupt mainline processing and cannot be interrupted by another command but may 
be interrupted by other exits in asynchronous activity. 

Long Running Commands 

A long running command is a command that is able to suspend processing to allow 
other activity, such as operator commands and data retrieval, and then resume. All 
the NetView components are long running commands. NetView command list lan- 
guage, REXX and HLL command procedures are long running commands. For an 
assembler command, the DSIPUSH macro provides the capability to run as a long 
running command. 

Long running commands run under an OST, NNT, PPT, and (limited) DST. They may 
be invoked directly by operator input, called by a command list, or called by another 
long running command. They return control to the NetView program after sched- 
uling work but before processing is complete. The NetView program then processes 
other work that may be pending. 

Long running command processors are often used to retrieve data from another task 
or from another domain without allowing the calling function or calling command list 
to proceed in the midst of this retrieval. During this retrieval, the processor's task 
may continue to receive messages and accept commands. 

Data Services Commands 

A data services command processor (DSCP) runs under the DST subtask environ- 
ment. DSCPs perform CNM data services, or VSAM data services, or both. DSCPs 
are also appropriate for centralized or serialized user-defined functions that do not 
use CNMI or VSAM services. 
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Defining Transactions - Exits and Commands 

There are two types of transaction programs you may provide within the NetView 
task environments: user exits and command processors. The programming inter- 
face details are provided in NetView Customization: Using PL/I and C and NetView 
Customization: Using Assembler. In designing user-written functions you will use 
the user exit interface and the command processor interface in the'NetView 
program to fit your own programming into the overall structure of the NetView 
program. 

User Exit Programs 

Global user exits are provided in the NetView program at several points in the proc- 
essing of logon and logoff data, command buffers, and message buffers. Different 
exits are driven based on the origin of the buffer and the stage of the NetView 
program processing that the exit is in. Special exits are driven under DSTs to 
handle data during initialization, input, and output under these tasks. For a 
summary of the NetView user exits refer to NetView Customization: Using Assem- 
bler and to NetView Customization: Using PL/I and C. 

General user exits are identified and invoked with preassigned module names of 
DSlEXnn, and the DST exits are identified uniquely for each DST in its task DSTINIT 
initialization statements. 

Command Processors 

NetView command processors can be started as a result of: 

• An operator request 

• A command buffer queued to a task for processing by any program in NetView 

• A command call from another command processor 

• An action specified in the message automation table. 

A command procedure may be written in NetView command list language, REXX, 
PL/l, C, or assembler language. Those that are written in NetView command list lan- 
guage or REXX are defined as command processors to the NetView program by 
placing them into the NetView command list library (ddname DSICLD). Other 
command processors must be link-edited into the NetView load library (ddname 
STEPLIB), and must be defined to the NetView program with a CMDMDL statement in 
the DSICMD member of the NetView parameter library (ddname OSiPARM). 

You may implement a function as a number of different user exit programs and 
command processors, each designed to perform a separate part of the overall func- 
tion. A common split of function across command processors is to divide proc- 
essing between OSTs and DSTs. Since OSTs receive data from operator stations and 
present data back to them, a command processor is written: 

• to be called when the command is entered by an operator 

• to parse the command data and form a data services request 

• to queue a command buffer containing the data services command to be proc- 
essed by the DST 

• to provide an error message or a command confirmation message back to the 
operator. 

The DST completes the function in a separate command processor that is called as a 
result of the command buffer that was built and queued by the first command 
processor. Under the DST, functions requiring the special data services of VSAM, 
external logging, or the VTAM CNMI are performed and messages may be issued 
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back to whichever operator task queued the command. Figure 1 on page 8 shows a 
typical program design for a function which uses the CNMI and VSAM services. 
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Figure 1. Program Design Example for DST Function 



Another important method for breaking up a complex function into a sequence of 
separate transactions is called Long Running Command support in the NetView 
program. Command processors may use this support to establish a named stack 
entry where an anchor address can be saved and retrieved. In this way, one 
command processor may perform some processing and save its results in storage. 
A related command processor may later retrieve the address of this storage from 
the long running command stack and perform another phase of the same proc- 
essing. 



Adding Optional Tasks to the NetView Program 



The recommended method of writing a user subtask is to use the existing DST 
subtask as a base. This is the only method supported in PL/I and C. The other, 
more complex method is to write a completely new subtask in assembler language, 
which the NetView program starts as an optionalOPT, or subtask. For an OPT, you 
must supply code for the subtask's initialization, exit, message, and command proc- 
essing functions and termination. Since some of these elements are already pro- 
vided in an existing DST subtask, using the DST as a starting point is generally the 
more practical approach. For more information on OPTs and DSTs in assembler see 
NetView Customization: Using Assembler. For implementing DSTs in high-level lan- 
guage, see NetView Customization: Using PL/I and C. 
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Choosing an Application Program Interface 



One application program interface may be more suitable than another for your par- 
ticular customization requirement. The effects on performance, ease of creation, 
and maintenance should be considered when determining which interface to use. 



Performance 



Performance-critical applications should be written in a compiled language. Gener- 
ally, compiled or assembled command procedures execute faster than interpretive 
(REXX and NetView) command lists. 

NetView-driven exit routines must be written in a compiled or assembled language. 
Any command processor that accesses NetView control blocks must be written in 
assembler. Command procedures that can be driven by terminal input or by mes- 
sages and do not need to access NetView control blocks can usually be written in 
REXX or in NetView command list language. 

Preloading a REXX or NetView command list (via the LOADCL command, see 
NetView Operation for information on this command) improves overall performance 
of the command list when compared to a command list which has not been pre- 
loaded. For additional performance recommendations, see NetView Tuning Guide 
and NetView Installation and Administration Guide. 

Ease of Creation 

REXX and NetView command lists are usually easier to create and debug than com- 
piled command procedures. This is primarily due to the interactive debug capa- 
bility, the availability of higher-level functions and commands, and the fact that you 
need not consider variable data typing. 



Maintenance 



Updating and maintaining REXX and NetView command lists is easy because the 
changes can be incorporated and tested online without having to restart the NetView 
program. Compiled command procedures must be link-edited into a load library 
and may require the NetView program to be restarted depending on whether the 
module is loaded for each execution. Table 2 on page 10 lists additional applica- 
tion program interface capabilities. 
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Table 2. Selecting an Application Programming Interface 



Function 


Command List 


PL/I or C 


Assembler 


Send message to NetView operator 
in line mode 


Yes 


Yes 


Yes 


Interact with operator through 
NetView operator screen (PAUSE/GO 
command) 


Yes 


Yes 


No 


Invoke NetView commands 


Yes 


Yes 


Difficult 


Trap and process messages des- 
tined for an operator 


Yes 


Yes 


Difficult 


Access task and common global var- 
iables 


Yes 


Yes 


No 


Create and access named areas of 
storage 


No 


Yes 


Yes 


Interact with operator through full 
screen panels 


via view 


via VIEW 


Difficult 


Communicate non-SPCI data over 
the CNMI 


No 


Yes 


Yes 


Access DASD files 


Limited 


Yes 


Yes 


Program debugging support pro- 
vided 


Yes 


Yes 


No 


Implement NetView user exits 


No 


Yes 


Yes 



Access NetView control blocks 



No 



No 



Yes 
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Logging 



The NetView program provides several methods for logging information. Table 3 
indicates features of the common logging methods available. 



Table 3. Features of NetView Logging Methods 



Feature 


Network Log 


External SMF 
Log (MVS 
only) 


External 

User-Defined 

Log 


NetView 
Sequential Log 


Access method 


VSAM 


VSAM 


Sequential 


BSAM 


Device- 
independent 


No 


No 


Yes 


Yes 



Function pro- 


Record all 


Service level 


User-defined 


Base service for 


vided 


operator 


verification 




user-defined 




station 


and 




functions 




activity 


accounting 







API-HLL 


CNMSMSG 


CNMSMSG 


CNMSMSG 


CNMSMSG 


API -Assembler 


DSIWLS 


DSIWLS 


DSIWLS 


DSIWLS 



Begin recording START 



See NetView 
Installation 
and Adminis- 
tration Guide 



See NetView 
Installation 
and Adminis- 
tration Guide 



See NetView 
Installation and 
Administration 
Guide 



Browse 


NetView 
BROWSE 


No 


Operating 

system 

browse 


Operating 
system browse 


Multiple log 
tasks 


No 


No 


No 


Yes 


Variable length 
blocks and 
records 


No 


Yes 


Yes 


Yes 


Primary /secondary 
data sets or 
files 


Yes 


System con- 
trolled 


No 


Yes 


SWITCH, 

RESUME, 

AUTOFLIP 


Yes 


N/A 


No ' 


Yes (No 
RESUME in VM) 



User exits 



Many 



XITXL 



XITXL 



XITBN, XITBO 



For more information on the Network log, see NetView Problem Determination and 
Diagnosis and NetView Installation and Administration Guide. Information on 
external logging using either System Management Facility (SMF) or a user- defined 
log or sequential logging refer to NetView Installation and Administration Guide. 
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Chapter 2. Using the VIEW Command 



This chapter describes the VIEW command processor, which is used to display 
full-screen panels from user-written programs. This chapter provides general-use 
programming interface information. (General-use programming interfaces are 
defined in "Special Notices" on page iii.) 

Using VIEW, users can design their own panels controlling the color and highlighting 
of panel text. 

The VIEW command allows command lists or command processors written in a 
high-level language (HLL) to interact with an operator by means of full-screen 
panels. The data from the command list or HLL variables can be substituted into the 
panels. 

You can use VIEW to create a rollable application. See "Creating a Rollable Compo- 
nent with VIEW" on page 19. The panel being displayed can contain multiple input 
fields whose contents can be returned, along with the Attention Identification (AID) 
information, to the calling command list or HLL command procedure. Incoming mes- 
sages can dynamically update the contents of the panel being displayed. 

The NetView program supplies a number of command lists that use the VIEW 
command to display full-screen panels. Displaying a new panel by invoking VIEW 
from a command list requires that you either modify an existing command list or 
write a new one. (If you change an IBM-supplied command list, you should first copy 
it into your own command list data set and change its name.) 

When modifying or writing a command list for your new application or sequence of 
panels, use the VIEW command and specify NOINPUT to display online help panels. 
See Chapter 3, "Modifying and Creating Online Panel Interfaces" on page 35 for 
more information on how to code help panel hierarchies. The VIEW command is 
intended to be used only from a command procedure. In addition, the SHOWCODE 
command list may be used to display VIEW'S nonzero return codes and associated 
explanatory messages. See "Displaying VIEW Return Codes" on page 33 for 
details. Code the command as follows: 



VIEW namel name2 [{MSG|NOM^}][{fNPUT|NOINPUT}] 



namel 

A name (1 to 8 characters) to be used internally by the NetView program. The 
first character must be alphabetic. A distinct name should be used for each 
separately rollable application. For compatibility with prior releases of the 
NetView program, characters 3-9 are allowed. 

name2 

The name (1 to 8 characters) of the panel to be displayed. 

MSG 

If MSG is specified, the panel display is interrupted by any message received by 
the operator station task (OST) under which the VIEW command is running. This 
allows the contents of the panel being displayed to be refreshed without 
requiring operator intervention. An incoming message can drive a command 
procedure that updates some of the variables substituted into the displayed 
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panel. When the command procedure completes, the VIEW command processor 
resumes, and the contents of the displayed panel reflect any changes to the var- 
iables made by the command procedure. If MSG is specified, the panel can be 
refreshed while entering data. 

NOMSG 

When NOMSG is specified, incoming messages do not interrupt the panel being 
displayed. This is the default. 

INPUT 

Returns input values, AID information, and cursor location to the procedure 
invoking the VIEW command. When using the VIEW command with the INPUT 
option, always issue the UNIQUE command first. If the INPUT option is not speci- 
fied, using the UNIQUE command is optional. See "Using the UNIQUE 
Command" on page 20 for more information. 

NOINPUT 

When the NOINPUT option is specified, the VIEW command does not return any 
information to the procedure that invoked it. This is the default. If the panel 
defines a command line, input is treated by the NetView program as a 
command. See Figure 10 on page 36 for the PF keys provided by the NetView 
program when NOINPUT is specified. 



Panel Definition for Use with VIEW 

The definition statements described in this section are those that are common to the 
VIEW command with either INPUT or NOINPUT options specified. 

Controlling Color and Highlighting of Fields 

You can change the color and highlighting of existing panels or add color and high- 
lighting to panels you create. Text color and highlighting in the displayed panel are 
controlled by attribute symbols or attribute variables. Once attribute symbols are 
coded in the source panel, they appear as blanks in the displayed panel. 

Scanning for attribute symbols or variables in a particular line occurs only if column 
1 contains an attribute symbol, or column 1 contains a variable which has an associ- 
ated attribute variable. Otherwise, the line is displayed as is from the panel 
description in the default color and without variable substitution. 

Note: Color and highlighting depend on the kind of terminal you are using. 

Attribute Symbols 

Attribute symbols are defined on the source panel to color or highlight text. Edit the 
source panel and replace the blank space before the text with the appropriate attri- 
bute symbol selected from the second column of Table 4 on page 15, or Table 5 on 
page 15. 

An option specified in the header of each panel determines which set of attribute 
definitions should be used for that panel. If no option ("***■) is specified, the ori- 
ginal set (Attribute Set 1) of special character interpretations is used. Attribute Set 2 
is used when specified on the text indicator line of the panel definition ("*** AT2"). 
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Table 4. Set 1 Color and Highlighting Attributes 



Attribute Set 1 


Symbol 


Hex Character 


Intensity 


Field 


White 


% 


X'6C 


High 


Text 


Reversed White 


} 


X'DO' 


High _ 


Text 


Underscored White 


I 


X'5A' 


High. 


Text 


White 


~ 


X'AV 


High 


Input 


Turquoise 


$ 


X'5B' 


Normal 


Text 


Underscored Turquoise 


\ 


X'EO' 


High 


Text 


Blue 


+ 


X'4E' 


Normal 


Text 


Reversed Blue 


{ 


X'CO' 


High 


Text 


Green 


@ 


X'7C 


Normal 


Text 


Yellow 


-I 


X'5F' 


Normal 


Text 


Pink 


i 
i 


X'6A' 


Normal 


Text 



Red 



X'4A' 



High 



Text 



7ab/e 5. Set 2 Color and Highlighting Attributes 



Attribute Set 2 


Symbol 


Hex Character 


Intensity 


Field 


White 


% 


X'6C 


High 


Text 


Reversed White 


} 


X'DO' 


High 


Text 


Reversed Red 


! 


X'5A' 


High 


Text 


White 


~ 


X'AV 


High 


Input 


Turquoise 


$ 


X'5B' 


Normal 


Text 


Reversed Green 


\ 


X'EO' 


Normal 


Text 


Blue 


+ 


X'4E' 


Normal 


Text 


Reversed Blue 


{ 


X'CO 1 


Normal 


Text 


Green 


@ 


X'7C 


Normal 


Text 


Yellow 


-n 


X'5F' 


High 


Text 


Reversed Yellow 


1 
1 


X'6A' 


High 


Text 



Blinking Red 



X'4A' 



Normal 



Text 



Displaying Special Attributes 

If you want a particular symbol that doubles as an attribute to be displayed within a 
colored or highlighted row, place double quotation marks (") in front of the symbol. 
For example, if you want the left brace ({) to appear in text, type "{ in the source 
panel. If you want double quotation marks (") to be displayed, precede them with 
another set of double quotation marks; thus, type "". When the same hexadecimal 
values for these symbols are coded as part of Kanji text surrounded with shift-out 
and shift-in, they will not be treated as attributes. 

Be careful how you use the attribute for the color blue, the plus sign (+). If you want 
to assign the color blue to a variable defined by the NetView command list lan- 
guage, you must enclose the plus sign in single quotes (&COLOR = ' + '). Other- 
wise, the NetView program interprets the plus sign as a continuation character. 
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A special rule also exists for use of the dollar sign ($) and the "at" sign (@) within 
variable values. When a variable has a string value containing the dollar sign or the 
"at" sign, those characters will not be interpreted as color attribute symbols; they 
will instead be displayed. To obtain the color attribute effects of these symbols 
within variables, use the less than (<) and the greater than (>). symbols respectively 
(&COLOR= <$; &COLOR= >@). When not within variable values, the less than and 
the greater than symbols are displayed. 

Attribute Variables 

Attribute variables are assigned in the command procedure which drives the view 
panel. An alternative to defining attribute symbols on the panel or within the vari- 
able data is to define attribute variables that are associated with panel variables. 
Attribute variables describe attributes associated with panel variables and their fol- 
lowing text on the same line. Using an attribute variable provides a wider range for 
attribute selection and allows definition of input fields. When using an attribute vari- 
able, the contents of the associated panel variable are not scanned for attribute 
symbols. 

An attribute variable name is formed by concatenating a dollar sign onto the front oi 
the panel variable name. For example, in NetView command list language, the attri- 
bute for panel variable &V1 is defined in a variable called &$V1. In REXX and HLL, 
the & is not used. 

The following is the syntax for the contents of an attribute variable: 
attribute variable ='tv tv tv...' 

where tv is the type value pair. Multiple pairs of the same type in one attribute vari- 
able are allowed; the last one is accepted and the previous ones are ignored. The 
values for type value are as follows: 

tv = type value 
F= Field 

FA Protected - data cannot be entered on displayed panel, this is the 
default 

Fl Unprotected - data can be entered on displayed panel 
I = Intensity 

IN Normal intensity; default if no intensity value is specified 

IH High intensity 

ID Dark, nondisplayable 
C = Color 

CD Default color for device; default if no color value is specified 

CW White or neutral 

CB Blue 

CR Red 

CP Pink 

CG Green 

CT Turquoise 

CY Yellow 
H= Highlight 

HD Default extended highlighting; also, default if no highlighting value 
is specified 

HB Blinking 

HR Reverse video 

HU Underscored 
U = Cursor 

UN Cursor will not be placed at this field, this is the default. 
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UY Cursor will be placed at the beginning of this field. UY specifica- 
tions for multiple variables cause the last one specified to be 
accepted and the previous ones to be ignored. 

Note: If no cursor is specified for any attribute variable on a panel 
the cursor will be placed at the beginning of the first input field. 

Consecutive blanks between type value pairs define a delimiter. The following is a 
NetView command list language example where &V1 is defined as a protected field 
with high intensity in red. &V2 is defined as a protected field in high intensity, in 
turquoise, with the cursor placed here. 

&$V1 = 'FA IH CR' 
&$V2 = 'IN IH CT UY IH' 

In the following REXX example, V1 is defined as an input variable (unprotected field) 
with no cursor. For V2, all the defaults are used. 

$V1 = 'FI UN' 
$V2 = ' ' 

Attributes defined by attribute variables or attribute symbols apply until one of the 
following occurs: 

1. The end of the line, or 

2. The explicit placement of an attribute symbol later in the line, or 

3. A variable is encountered later in the line that has either: 

a. A valid attribute variable that specifies new attributes, or 

b. No valid attribute variable but contains one or more attribute symbols. 

Constants or variables defined on a panel can become part of an input field and are 
updated only when you type over some portion of the input field. When you type on 
an input field, the entire contents of the input field are assigned to the panel vari- 
able. 

The first byte of a field defined by a panel variable (the &) is used for attribute spec- 
ification, and is followed by the contents of the variable. If an attribute variable cor- 
responds to a panel variable, it takes effect at this first byte even if the panel 
variable is not found (and is replaced by blanks). 

Trailing blanks in a field defined by the panel or caused by variable padding are 
replaced by nulls on the output panel. A distinction is made between trailing blanks 
in the variable (not replaced) and those caused by panel definition or padding 
(replaced by nulls). For example, if &VAR contains the value z and the panel line 
containing &VAR included &VAR !, the blank following the Z is output as a blank while 
the rest of the field up to the attribute symbol (!) is output as nulls. This allows you 
to use the insert key for character insertion in an input field. 

Note: If an attribute variable contains a syntax error, message CNM944I is written to 
the NetView log if it is active. 



Displaying Variables in Source Panels 



When VIEW attempts to resolve a variable name coded on the panel. definition state- 
ment, it checks first to see if the variable is a NetView control variable. If the vari- 
able name is found, the appropriate NetView control variable is substituted. 
Otherwise, VIEW searches for a variable of the same name defined by the command 
procedure that invoked the VIEW command. For example, if the variable name 
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&OPI0 is coded in the panel definition, the value for the control variable &OPID is 
always substituted instead of the value of a command procedure variable named 
OPID. If a variable name is not defined to the NetView program or defined in the 
calling command procedure, the variable coded on the panel is displayed as a 
string of blanks. 

You can use only 1 to 11 alphanumeric characters (A - Z and 0-9) for the variable 
names in VIEW panel definitions. Alphabetic characters must be in uppercase. Vari- 
able names also must conform to any other variable naming conventions set by the 
language invoking VIEW if the variable is to be referred to by that language. For 
example, variable names used in HLL and REXX must start with an alphabetic char- 
acter. 

For the VIEW command to find global variables, the global variables must have been 
referenced by the command procedure prior to executing the VIEW command. 
Global variables are defined by &TGLOBAL or &CGLOBAL in NetView command list 
language, GLOBALV in REXX, CNMVARS in PL/l, or Cnmvars in C. See NetView 
Customization: Writing Command Lists for more information on global variables. 

Note: A REXX user who calls VIEW to display global variables, or to allow over- 
writing global variables by defining them in an input field, must: 

1. Issue a 'GLOBALV GETT (or GETC) varname' before invoking VIEW. 

2. Initialize varname or make sure it has a non-null value before invoking VIEW. 

If the previous steps 1 and 2 are done, the global varname is displayed and is 
updated if varname has an attribute variable that makes it an input field. Otherwise, 
the REXX local varname is displayed and updated. When view accesses a global 
variable this way, any REXX local variable with the same name is not affected by 
VIEW. 

If a NetView control variable (for example, APPLID or OPID) is named on a VIEW 
panel, VIEW displays the control variable value and cannot access a REXX local vari- 
able with the same name. Control variables cannot be updated. 

The following REXX example shows how VIEW can be used to allow the operator to 
update a global variable. 

/* V 

'GLOBALV GETT XYZ' 

IF XYZ = " THEN 

DO 
XYZ = ' 
'GLOBALV PUTT XYZ' 

END 

$XYZ = 'FI' 

VIEW NAME1 TESTPANL INPUT 
'GLOBALV GETT XYZ' 
SAY XYZ 
EXIT 

If the length of the value assigned to the variable exceeds the length of the variable 
in the source panel, and if the variable is followed by alphameric or special charac- 
ters (such as !, 0, \, |, @, #, $, %, -•, &, ", +) on the panel definition, the value is 
truncated. When a variable is followed by characters other than these (such as a 
period or a dash), the characters are overwritten. 
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You can assign a particular color to a variable by defining an attribute variable. See 
"Full-Screen Input Capabilities" on page 21 for an example showing how variables 
in source panels are displayed. 

Creating a (tollable Component with VIEW 

A NetView component is a command or command procedure that controls the 
terminal 's screen, provides for operator entry of arbitrary NetView commands, and 
is capable of resuming when such commands are complete. In a command proce- 
dure, you can create a rollable component using VIEW to provide the necessary 
screen control. 

If you specify the NOINPUT option, and your panel has a command line (see page 
37), VIEW handles the operator command interface for you. If you specify the INPUT 
option on your VIEW command, you provide a command line at the bottom of your 
panel. VIEW returns the operator's input to your procedure in the form of named 
variables. 

Issuing Commands from Command Procedures 

When a command is issued directly from a command procedure, the procedure is 
suspended until that command completes. When the called command is complete 
and the return code is available, the procedure resumes execution. If the called 
command is a long running command, it and the calling procedure form a group that 
is treated as a unit by the NetView program 's ROLL command (roll group). 

Note: An exception is the BGNSESS FLSCN command, which allows a calling proce- 
dure to complete before the session begins. This is done by using the MINOR option 
of DSIPUSH. (See NetView Customization: Using Assembler for information on 
DSIPUSH.) 

Such grouping is beneficial if the intent is to build a hierarchy of related panels, 
using different procedures to build each orje. The grouping is not desirable when 
executing unrelated commands, such as those received from an operator. 

To disassociate an unrelated command from the calling procedure, use the CMD 
command. For example, if an operator's command is the value of a variable 
cmdline in your REXX procedure, issue *CMD HIGH' cmdline to queue the command 
and to return control to your command procedure. When the queued command is 
processed, it is asynchronous and not related to current processing. Thus, if an 
operator types STATMON on your panel 's command line and then issues ROLL from 
STATMON, your procedure regains control even though STATMON is not complete. 
Queuing, rather than calling a command, protects your procedure from any reset 
condition this command might encounter. (See NetView Customization: Using 
Assembler for more information on the ROLL function.) 

Using the UPPER Command 

When issuing a command that was specified from a VIEW panel when the INPUT 
option was specified, and the application is coded in a high-level language (HLL) or 
in the NetView command list language, the command MUST BE translated into 
uppercase in order for the NetView program to recognize it. This can be accom- 
plished with the UPPER command. The UPPER command changes the contents of the 
specified variables to uppercase. An example of the UPPER command can be found 
in Figure 4 on page 23. Code the command as follows: 
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UPPER; variable vart,...var2 

variable vaii,...var2 the 1- to 31- character name of the variable to be translated to 
uppercase. 

Usage Notes: 

When coding in the NetView command list language, do not specify the leading "&" 
in front of the variable name. 

When more than one variable is specified, all variables will be translated, even if 
one of the variables has an error condition (not found or invalid length). 

Return Codes: 

Successful completion of all specified variables. 

4 At least one variable not found. 

8 At least one variable length not within range. 

12 At least one variable not found and at least one other variable length not 
within range. 

16 Not invoked from a command procedure. 

20 No variables specified. 

Using the UNIQUE Command 

The NetView program allows an operator to start many copies of the same 
command processor. In some cases, you may not want more than one copy, such 
as when creating a NetView component. By using DSIPOP or OSIPUSH with the 
PROMOTE option, assembler programmers guarantee the uniqueness of their long 
running commands. Using the UNIQUE command will achieve the same type of 
uniqueness in a command procedure. Issuing UNIQUE from your procedure has no 
effect (and gives a zero return code) if the current copy of the procedure is the only 
one active. An active long running command or procedure is one that is in any 
stage of its processing but not yet complete. This includes procedures that are sus- 
pended (blocked) by some other long running command. If another copy of the 
same procedure exists under the same task, UNIQUE has an effect on the entire roll 
group that includes that copy. 

When using UNIQUE with the CANCEL option (the default), the calling procedure is 
temporarily suspended while the older copy is given control with a reset condition. 
In this case, the NetView program suppresses the cancellation messages normally 
issued when a procedure is reset. When the canceled copy of the procedure and 
any others in its group complete, the issuing copy resumes with the next line after 
the UNIQUE command. The return code is set to 4. 

Using UNIQUE with the PROMOTE option promotes the previous copy of the calling 
procedure and its roll group to the top of the roll stack, ready to resume when the 
copy issuing UNIQUE completes. The return code is set to 4 in this case also. 

When using UNIQUE in NetView command list language, code a suppression char- 
acter to suppress unwanted command echoes when the command has an error. 
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Code SIGNAL ON HALT in your REXX procedures to suppress the REXX cancellation 
message. The HALT subroutine should return a —5 return code. 

Note: No special processing is required for the ROLL command. It is issued exactly 
like other NetView commands. To be consistent with other Net View applications, set 
PF6 and PF18 to issue the ROLL command. 
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The VIEW command allows the contents of multiple input-capable variables on a 
panel, along with the AID information and cursor location, to be returned to the 
invoking procedure. This is specified with the INPUT keyword and by coding an attri- 
bute variable with the Fl type value pair. 

Note: When using the input option, you have an input field only if you defined an 
attribute variable specifying input. (See "Attribute Variables" on page 16 for infor- 
mation on the type value pair.) When the panel is displayed, it contains the variable 
values that can be modified by typing over them. The modified variables are 
returned to the invoking procedure when an AID key is pressed. Table 6 describes 
the AID key. The following variables are set on return to the calling command 
procedure: 

Table 6. Variables Set On Return to Calling Command Procedure 

NetView Command List 
REXX and HLL Language Description 

viewaid &VIEWAID The aid key used to enter 

the input. 

VIEWCURROW &VIEWCURROW The cursor location (row) 

when the AID key was 
pressed. 

VIEWCURCOL &VIEWCURCOL The cursor location 

(column) when the aid key 
was pressed. 

The contents of the VIEWAID variable are defined as PF1, PF2 PF24, PA1, PA2, PA3, 

or Enter. 

If PA1, PA2, or PA3 is pressed, only the AID (VIEWAID) information is returned to the 
invoking procedure. The cursor row and column locations and any input fields 
defined on a panel are not returned. 

The following five figures illustrate source panels using VIEW with the INPUT option 
to create a rollable component. Figure 2 on page 22 and Figure 3 on page 22 
show the source panels containing input-capable variables to be replaced. These 
panels are using attributes from Attribute Set 2 (see Table 5 on page 15). 



Chapter 2. Using the VIEW Command 21 



•»xs«sa3»«s»>3au»xx>su>sx9w>a>i 



issattsaanBsssaaasn 



/«**it«»* i>«« * «>t<ll > >> ll »««t«»l > <>>t »»»»* * «»»*« M '»» «» « '>l >« « »l >» «*'>> > »*»> »* «l>«i 

7* FIRST PANEL DISPLAYED */ 

/* 

*** AT2 
+PANEL1 
$ X- 
$ I 
$ I 
$ I* 
$ 1% 

% 1% 
$ i% 
$ 1% 



RRRRRRK AAAAAAA NN NK EEEEEEEE LL 

RR RR A* AA NNN NN EE LL 

RRRRRRRR AAAAAAAAA MM NN NN EEEEEEEE LL 

AA AA m NNM EE 



RR 
RR 



LL 



III $ 

11 11 $ 

11 t 

11 $ 



AA 



AA NM MN EEEEEEEE LLLLLLLL 11111111$ 



$ I 
$ I 
$ I 
$ I 
$ \ 
$X» 



INPUT VARIABLE I 
INPUT VARIABLE 2 



&VARIMI 
&VARIN2 



You entered: &VAROUT1 
You also entered: 4VAR0UT2 



«x 



$Enter a command on the command line ^V.V 

$Enter NEXT or press PF8 to view the next panel- 

$ 

%Action«> &C0MMAND H 

$ PF2» En* 

$ PF6/PF18- Roll PF8»Next 
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The REXX command procedure shown in Figure 4 invokes VIEW with the INPUT 
keyword to display PANEL1. It assigns* initial values to the VARIN1 and VARIN2 
input-capable variables in the source panel. It also returns the AID information and 
command line input to the caller. 

/*********•**************************************** 

/* EXAMPLE: NETVIEW COMPONENT USING THE VIEW COMMAND */ 

/********************************************^ 

SIGNAL ON HALT 

/* RESUME OLD COPY IF ONE EXISTS */ 

•UNIQUE PROMOTE' 

if re = 4 then EXIT -5 /* -5 will cancel caller if it exists */ 

SIGNAL ON ERROR /* any nonzero re other than as a result of the */ 

/* UNIQUE command is an error */ 

/* set up VAR1 and VAR2 as input capable fields */ 

/****************************************^ 

$VARIN1 = 'FI IN CR HB UN' 

$VARIN2 = 'FI IH CG HR UN' 
/****************************************^ 

/* set up COMMAND as an input command line using an attribute */ 

/* variable. Also define the cursor to stop at this field. */ 

$C0MMAND - 'FI UY' 
VARIN1 = 'INITIALIZE 1' 
VARIN2 = 'INITIALIZE 2' 
Do forever 
COMMAND = 'OO'X /* COMMAND = null char (this clears */ 

/* the command line and provides */ 
/* for insert capability) */ 
'VIEW USERAPPL PANEL1 INPUT' 
UPPER COMMAND 
VAR0UT1 = VARIN1 
VAR0UT2 = VARIN2 
SELECT 
When viewaid = PF2 then exit 
When viewaid = PF6 then CMD HIGH ROLL 
When viewaid = PF8 then call PANEL2 
When viewaid = ENTER then 
SELECT 
when command = NEXT then call PANEL2 

/* Assume any other input given on command line is */ 
/* to be issued to NCCF */ 

when COMMAND -•= ' ' then 
DO 

'CMD HIGH' COMMAND 
END 
otherwise nop 
END 
OTHERWISE nop 
End - /* select */ 

End /* Do forever */ 

Figure 4 (Part 1 of 2). REXX Command Procedure that Drives a Rollable Component 
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UPPER COMMAND 












SELECT 












When viewaid = 


PF2 


then exit 








When viewaid = 


PF7 


then return 








When viewaid = 


PF6 then 'CMD HIGH 


ROLL 


When viewaid = 


ENTER then 








SELECT 












When COMMAND 


= BACK then 


return 





COMMAND = null char (this clears */ 
the command line and provides */ 
for insert capability) */ 



/* Quit if PF2 */ 

/* Previous panel PF7*/ 

/* Roll if PF6 */ 



/•••A******************************************************** 

/* Assume any other input given on command line is */ 

/* to be issued to NCCF */ 

when COMMAND ^= • ' then 
DO 

'CMD HIGH' COMMAND 
END 
otherwise nop 
END 
OTHERWISE nop 
End /* select */ 
End /* Do forever */ 
RETURN 
ERROR: 

EXIT -1 /* -1 means "FATAL ERROR IN NESTED PROCEDURE" */ 

HALT: 
EXIT -5 /* -5 means "CANCEL REQUESTED" */ 

Figure 4 (Part 2 of 2). RE XX Command Procedure that Drives a Rol table Component 

Figure 5 on page 25 is a typical display of this panel. The variables VARIN1 and 
VARIN2 have been replaced with actual values INITIALIZE 1 and INITIALIZE 2, respec- 
tively. (See Figure 2 on page 22 for the source for this panel.) The attribute spec- 
ification has been defined by $VARIN1 and $VARIN2 (see "Attribute Variables" on 
page 16 for more information). 

VARIN1 attributes are: 

Input, tab (unprotected) 

Normal intensity 

Red 

Blinking 

No cursor position. 

The length of the input field continues until the next attribute symbol is encountered. 
In this case it is %. 

VARIN2 attributes are: 

Input, tab (unprotected) 
High intensity 
Green 

Reverse video 
No cursor position. 
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The length of the input field continues until the end of the line. 



COMMAND attributes are: 



Input, tab (unprotected) 
Position the cursor at this field. 
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Figure 5. First Display Panel of Component with Variables Replaced by REXX Command 
Procedure 
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Returning Command Line Input 



NOINPUT specified: For the NetView program to process the command line when 
NOINPUT is specified, you must define a tilde (— ) on the panel to be displayed. 

The tilde definition defines an input field on the panel that is to be returned to the 
NetView program as a command. An &CUR coded on this line after the tilde deter- 
mines where the cursor is to be positioned. 

The &CUR is particularly useful for predefining a partial command. For example: 

~ V NET,ACT,ID=&CUR 
coded on a panel would display 

V NET,ACT f ID=_ 
with the remaining 10 to be completed by the operator. 

Only one command line tilde and only one &CUR are allowed per panel. See 
Figure 10 on page 36 for the PF keys provided by the NetView program when 
NOINPUT is specified. 

INPUT specified: When INPUT is specified, the command line should be coded the 
same as any other input-capable field. The &CUR and tilde definitions should not be 
used. It is the responsibility of the procedure that is displaying the panel to issue 
any commands. See "Issuing Commands from Command Procedures" on page 19 
for information on issuing CMD HIGH. 

Dynamic Update Capabilities — MSG Option 

The VIEW command enables you to dynamically update the contents of the panel 
being displayed. All panel variables that might be updated by message automation 
should be declared as global variables in a NetView command list or hll command 
procedure that uses the VIEW command. VIEW displays a panel, and the contents of 
the global variables are substituted. The incoming messages may dynamically 
update some of the global variables currently displayed on the panel. If MSG is 
specified, a displayed panel is interrupted by any message received by the OST 
under which VIEW is running. The contents of the displayed panel can then be 
refreshed without operator intervention. When NOMSG is specified, incoming mes- 
sages do not interrupt a displayed panel. 

You can code a command procedure to invoke VIEW with the MSG option. Code a 
message automation table entry to trap the message and execute a second 
command procedure to update the variables. The first command procedure 
declares global variables and invokes VIEW. VIEW displays a panel substituting the 
contents of the global variables declared in the command procedure. When VIEW is 
interrupted by a message received at the OST, the incoming message drives the 
second command procedure that has updated some of the global variables currently 
displayed on the panel. The interrupted panel is redisplayed with- the new values of 
the global variables changed by the second command procedure. 
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Sample of Panel Updating 

The following four figures illustrate the dynamic update of the contents of a panel. 

Figure 9 on page 29, command list RESDYN, uses the RESOURCE command output 
to illustrate how to use the MSG operand of the VIEW command. The data displayed 
is updated on a time interval that you specify when invoking the command list 
(RESDYN); the default time interval is 10 seconds. 

Figure 7 shows a typical RESDYN command. 



CNMRESD NetView Resource Utilization 



11:59:18 



TOTAL CPU PERCENTAGE « 


» 0.95 


NETV3A CPU PERCENTAGE « 


8.10 


NETV3A CPU TIME USED « 


5.61 SEC. 


REAL STORAGE IN USE 


4912K 


PRIVATE ALLOCATED < 16M « 


■ 316K 


PRIVATE ALLOCATED > 16M • 


4296K 


LSQA ALLOCATED < 16M « 


80K 


LSQA ALLOCATED > 16M « 


8936K 



CMD ««> 



PF3/PF15* Return PF6/PF18- ROLL 



Figure 7. RESDYN Command Output Example 

RESDYN uses the MSG option so that the commands scheduled by EVERY can change 
global variables displayed and allow the panel to be automatically refreshed. You 
also specify the MSG option if updates were scheduled by message automation. 
Any other messages the operator receives are also processed. When RESDYN is 
scheduled by EVERY processing, it updates task global variables. Invoking the ori- 
ginal VIEW automatically picks up the new values when it resumes. 
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Figure 8 is the source panel text that displays the previous panel (Figure 7). 

+CNMRES0 NetVlew Resource Utilization ♦ ' W r ^ 

$ Total CPU Percentage » 40UTVAR2 '.. , 

t Ui' ePttPefcentagf-ftamf/^dfc^^'r, ? y '-T'-:'^,\ . 

t «J0* • CWTfteUsed « *aUTVAR# ! ? tv^'^- • T,> * 

$ Real Storage f n Use « MUTVA8S „...' 

$ Private Allocate* < 16M * MUTVARr 

$ Private Allocated > 16* » MUTVAR7 

$ LSQA Allocate* < m » MUTVARf , - . . * „; > J, 

$ LSQA Allocate* > IW * *IOUTVARr '*' r-*'-*' 

$ ■"■■ "■:'■': ::■. ;-,.'-^^..-'^:-^^-".':. ;;-;..;-S^-^^^'^ --■ . .■< .■ ■.. 

$ : •. ■*.:• - ■ .'•■■ ^i ■ ^ ££?^&%&&^^ >'.-., • -.■•■<: ■ - - - ' 1 

$ SPF3/PF15* Return $PF6/Pf 28* Roll ! 

F/gure 8. CNMRESD Source Panel 

VIEW manages the PF keys and the command line without intervention by the 
RESDYN command list. 
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Figure 9 shows the results of using VIEW in a command procedure (using the 
RESDYN command list) to display the results of the RESOURCE command on a 
full-screen panel. It also shows the use of VIEW by a command procedure. 



V 

Display the results of the RESOURCE command on a full screen panel. */ 
Syntax: RESDYN interval */ 

"interval" is the number of seconds (from l to 59) between updates. */ 

*/ 
*/ 
*/ 
V 
*/ 
*/ 
*/ 
V 

Always used with VIEW */ 
How were we driven? */ 
For update? (from EVERY) */ 

Yes, update global variables */ 
that's all! */ 



RESDYN runs in two modes: When invoked by an operator, it 
initializes, then issues VIEW. It also runs as a result of 
EVERY scheduling, for the purpose of updating the (global) 
variables with the data to be displayed. The original VIEW 
invocation automatically picks up the latest values whenever 
it is resumed. 



SIGNAL ON HALT 
SELECT 

WHEN msgvar(l) = 'UPD' THEN 
DO 
CALL TRAPRTN 
EXIT 
END 
WHEN msgvar(l) - " THEN 

timev ■ 10; 
WHEN DATATYPE (msgvar(l)) « 'MUM' THEN 
DO 
IF msgvar(l)<3 | msgvar(l)>59 THEN 

SIGNAL PARMERROR 
timev * right(msgvar(l),2, '0') 
END 
OTHERWISE SIGNAL PARMERROR 
END 



By operator, with default? 

Yes, default 1s 10 seconds 
By operator w/value? 
Yes, 
value acceptable? 

No, tell OP bad news. 

EVERY command needs 2 



I 
I 

V 
*/ 
*/ 
V 
digits*/ 



/* Any other way is bad. 



CALL TRAPRTN /* Initialize global vars */ 

Figure 9 (Part 1 of 3). RE XX Command List to Invoke RESOURCE Command Processor 
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'TRAP AND SUPPRESS MESSAGES DSI208I' /* trap output from EVERY */ 

/* When using VIEW with the NOINPUT option, UNIQUE is not ordinarily */ 

/* required. However, in this case, we want to be sure that there */ 

/* is not already a copy executing before issuing the EVERY command, */ 

/* which would fail, otherwise. */ 

/A********************************************************* 

'UNIQUE* 

/* at this point previous copy (if any) has completed. */ 
'EVERY 00:00: 'timev'.ID-RESDYN, RESDYN UPO' /* Schedule updates */ 
IF re -» THEN SIGNAL SCHDERROR 

/* Define display attributes for the variables in the panel. */ 

/* $0UTVAR2 is a global because it is changed by update processing. */ 

/* These variables do not need to be task global s because they */ 

/* are not updated when RESDYN is called for update. */ 

/* IH ■ high intensity */ 

/* CW = white CR = red */ 

$0UTVAR3 =■ 'IH CW' 

S0UTVAR4 = 'IH CW' 

S0UTVAR5 » 'IH CW' 

$0UTVAR6 = 'IH CW 

S0UTVAR7 =< 'IH CW' 

$0UTVAR8 = 'IH CW' 

S0UTVAR9 => 'IH CW' 

$TM = 'IH CP' 

/♦•♦♦A********************************************** 

/* Display a panel with the current values of the global variables. */ 
/* VIEW will automatically update the fields being shown whenever */ 
/* the values of the global variables are changed. */ 

/* */ 

/***************************************^ 

'VIEW RESDYN CNMRESD MSG* 

IF rc-=0 THEN 'SHOWCODE' re 'CNMRESD' 

"PURGE TIMER=RESDYN" 

EXIT 

Figure 9 (Part 2 of 3). RE XX Command List to Invoke RESOURCE Command Processor 
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/* This subroutine extracts information from the message produced by */ 
/* the RESOURCE command and sets task global variables. */ 

TRAPRTN: 

'TRAP AND SUPPRESS MESSAGES DSI386I ' /* trap output from RESOURCE */ 
'RESOURCE' 

IF re ■« THEN /* RESOURCE failed? under PPT? */ 

DO 
say "RESDYN's RESOURCE command failed with" re 

"UNIQUE CANCEL" /* Stop the 'main' copy for this error. */ 

EXIT /* Stop this one, too. */ 

END 

/* 'WAIT FOR MESSAGES' not necessary */ 
/* since message from RESOURCE are */ 
/* synchronous. */ 

'MSGREAD' 
IF re -«e THEN 
DO 
say "RESDYN's message read failed with" re 
EXIT 
END 

DO cntr - 2 to 9 

'GETMLINE LINE 'cntr cntr 
'PARSEL2R LINE 'cntr '/■/ RESULT' 
INTERPRET 'OUTVAR'cntr ' = VALUE("RESULT") ' 
IF cntr=3 THEN 

■PARSEL2R LINE' cntr 'JBN PI' /* Get the jobname */ 

END 

TM = TIME() 

IF 0UTVAR2 > 50 THEN /* CPU utilization is high? */ 

S0UTVAR2 - 'IH CR HR' /* High intensity, red, reverse */ 

ELSE 
$0UTVAR2 = 'IH CW /* High intensity, white */ 

'GLOBALV PUTT 0UTVAR2.0UTVAR3.0UTVAR4.0UTVAR5, ' , 
' OUT VAR6 , 0UTVAR7 , OUT VAR8 , 0UTVAR9 , TM ' 

'GLOBALV PUTT $0UTVAR2' /* This one changes, must be global. */ 
RETURN 

PARMERROR: /* Operator specified invalid time */ 

/* interval . */ 

say 'Invalid parameter' msgvar(l) 'for RESDYN, specify number' 
say 'between 3 and 59' 
exit 12 

SCHDERROR: /* EVERY command failed, shouldn't */ 

/* happen, 
say 'RESDYN cannot schedule updates. EVERY command failed with' re 
exit 16 

HALT: /* RESDYN has been reset, */ 

/* possibly by UNIQUE command 

"PURGE TIMER-RESDYN" 
EXIT -5 /* Requesting caller, */ 

/* if any, to cancel, also. 

Figure 9 (Part 3 of 3). RE XX Command List to Invoke RESOURCE Command Processor 
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Return Codes from VIEW 



Table 7. 


Return Codes from VIEW 




Code 


Meaning 


Your Action 


4 


Panel specified not found in cnmpnu or cnmmsgf 
data sets (MVS). 


Put panel definition 
in correct data set 
or file. 


8 


Panel definition format not valid; no noncomment 
lines found. 


Correct format of 
panel definition. 



16 VIEW command processor invoked with invalid 

parameters. Namel must be 1 to 8 characters and 
name2 must be valid panel name. Valid parameters 
are input, noinput, msg, nomsg. 



Correct command 
list to use valid 
option. 



24 


Full-screen command processor is available to OST 
only. 


Do not invoke VIEW 
from a non-OST. 


28 


Logical record length of panel not 80 bytes. 


Change data set or 
file to logical record 
length of 80 bytes. 


32 


Unrecoverable error resulted from macro call. For 
VM, error could be that panel specified was not a file 
with filetype NCCFLST. 


Call IBM for service. 


36 


Unrecoverable internal programming error 
occurred. 


Call IBM for service. 


81 


Panel definition format not valid; no text indicator 
line found, or more than 49 option definitions found. 
(See page 36.) 


Correct format of 
panel definition. 


82 


Panel definition format not valid; panel data stream 
exceeded 9600 bytes. 


Correct format of 
panel definition. 


83 


Panel definition format not valid; comment lines in 
wrong place. 


Correct format of 
panel definition. 


84 


Panel definition format not valid; more than 24 dis- 
playable lines found. 


Correct format of 
panel definition. 



85 Panel definition format not valid; more than one 

command line defined, or more than one &CUR 
defined in command line when view invoked with 
noinput specified. 



Correct format of 
panel definition. 
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Displaying VIEW Return Codes 



The SHOWCODE command list is used by command procedures to display 
descriptions of the return codes from the VIEW command. The descriptions are dis- 
played in the form of messages. You can use SHOWCODE for the same purpose 
when you create or customize your command procedures. 

These are the valid return codes and their related message IDs: 



4 


CNM335I 


8 


CNM336I 


12 


CNM337I 


16 


CNM338I 


24 


CNM340I 


28 


CNM341I 


32 


CNM342I 


36 


CNM343I 


81-85 


CNM336I 



See Figure 9 on page 29 for an example using SHOWCODE to display error mes- 
sages from VIEW. 

You can code similar functions into command procedures you create or customize. 
See NetView Customization: Writing Command Lists for more information. 
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Chapter 3. Modifying and Creating Online Panel Interfaces 

This chapter tells how to change the content of the online help facility panels in the 
NetView program. Online help uses the VIEW command which was described in the 
previous chapter. To use the PF keys, menu selection, and panel hierarchies 
described in this chapter, you must specify the NOINPUT option when you invoke the 
VIEW command. This chapter also tells how to create new panels for your own help 
applications. 

Note: If your panels or alert messages have been translated into Japanese (using 
Kanji), exercise great care to preserve the integrity of the double byte character set 
strings. 

Modifying Help Panels 

Reasons for modifying an online help panel include changing panel text and adding 
an item to a menu. The general procedure for modifying a displayed panel is to: 

1. Locate its source panel 

2. Copy the source panel 

3. Type your changes into the copy of the source panel 

4. Store the modified panel 

5. Test the modified panel. 

Locating a Source Panel 

The first step in modifying an online help panel is to determine the source panel that 
controls the panel you want to change. 

A source panel is a file that defines the contents of the displayed panel that appears 
on the end user's screen. A source panel contains the text of the displayed panel as 
well as definition statements that do not appear on the displayed panel. These defi- 
nition statements include a prolog, the name of the help panel for the particular dis- 
played panel, and a list of panels the operator can select to appear next. 

Source panels are stored in a data set concatenated to CNMPNL1 (for MVS) or in a 
file with filetype NCCFLST (for VM). For message help panels, the source is a VSAM 
file, CNMMSGF (for MVS and VM). 

To view the source panel for a particular displayed panel, enter: 

BROWSE panel _name 

where panel_name is the name that appears in the upper left corner of the dis- 
played panel. 

Modifying a Source Panel 

To modify a source help panel, use a screen editor such as ISPF/PDF (for MVS) or 
XEDIT (for VM). Make your changes to the source panel by typing over the existing 
text or by adding text. For message help panels, see "Modifying Online Message 
Panels" on page 39. The items of text you can change are numbered in the sample 
source panel shown in Figure 10 on page 36. The text that follows the figure 
describes these fields. 

Note: All panels must have a logical record length of 80 bytes. Null characters are 
also counted within this 80-byte record. 

© Copyright IBM Corp. 1989, 1990 35 



/* This is the main menu for the IfetView help desk. Q 
/* 

HELP-CNMHHINT HOW TO USE THE HELP OESKQ 

1 CNMHT1 THE TERMINAL DOES NOT WORK 

2 CNMHA1 APPLICATION PROBLEMS 

3 CNMHP1 PERFORMANCE PROBLEMS Q 

4 CNMHH1 PROBLEMS IDENTIFIED THROU6H NETWORK MONITORING 

5 CNMHM1 SYSTEM MESSAGE CROSS-REFERENCE 

*** Q 

+CNMHDESKH %NETVIEW HELP DESK& 

$ 

\Select+ To get information about 
1 

$A terminal not working 



$A transaction or an application not working 
$S1ow response time 

SProbiems identified through network monitoring 
SSystera message cross-reference 



$ %1 
$ 

$ %2 
$ 

$ %3 ,-.-„ ...„....> .._ 

$ Q 

$ %4 ~ 

$ 

$ %5 

$ 

-•-Type a number (i through 5) and press ENTER. 

$ 

% PF1 — Recommendations for Setup and Use of the help desk. 

$ 

% HELP NETVIEW — > $NetView Help Menu 

$ s — 

%Act i on»«>-&CUR Qj 

+ B3 %PF1« Help $PF2» End PF3- Return PF4- Top PF5- Bottom 

+ $PF6« Roll PF7- Backward PF8* Forward $PF11- Entry Point 







Figure 10. Sample Source Panel 

(The special characters you see in the source panel, such as the dollar sign ($) and 
the percent sign (%), are described under "Controlling Color and Highlighting of 
Fields" on page 14.) 

Q Prolog An optional section for programmer comments. Each line 

of the prolog begins with /* in columns 1 and 2. 



Q Help 



Q Option Definitions 



Optional text that defines the help panel (helppan) for a 
particular displayed panel. This field follows the prolog 
and is coded in this format: 

Col umn 

1 15 

HELP=he1ppan comment 

See "Naming a Source Panel" on page 40 for naming con- 
ventions. 

PF1/PF13 brings the specified help panel to the screen; 
PF3/PF15 brings the originating panel back. If the panel is 
continued on a second page, its continuation page is 
coded as described under Q . 

Optional list of panels from which the operator can select 
the next panel to be displayed. This list may not exceed 49 
option definitions. The list is coded in this format: 



Col umn 

1 3 

n panname 



12 
comment 



where n is the alphameric character by which the operator 
calls the panel. To produce a continuation panel, n is 
blank, as shown in the following example: 
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Col umn 
1 3 
panname 



12 
comment 



Q Text Indicator 



Qj Panel Text 



Q| Name 

Q Heading 

Q Text 

Q Message Area 

EJ Command Line 



In this case, panname identifies the continuation panel. 
See "Naming a Source Panel" on page 40 for naming con- 
ventions. 

Three required asterisks that separate the prolog, help, 
and option definitions from the displayed panel text. The 
three asterisks followed by a space and then the AT2 
option (•** AT2 or "*** KK AT2" for Katakana) indicate that 
Attribute Set 2 is to be used for color and highlighting. 
(For Attribute Set 1, use ***, or *** AT1. For Katakana, use 
"*** KK" or "*** KK AT1".) See "Controlling Color and 
Highlighting of Fields" on page 14 for more information on 
Attributes Sets 1 and 2. 

Up to 24 lines of text that constitute the displayed panel. 

Command list variables may appear anywhere in the 
panel text. See "Displaying Variables in Source Panels" 
on page 17 for more information. 

Name of the panel. See "Naming a Source Panel" on 
page 40 for naming conventions. 

Text that describes the use of the panel. 

Body of panel up to 18 lines. 

The 21st line of the panel, on which NetView messages 
appear. 

The 22nd line of the panel, on which NetView operators 
type commands to the NetView program. In a VIEW 
command with the NOINPUT option specified (see 
Chapter 2, "Using the VIEW Command" on page 13), at 
least one command line is defined by the ~ attribute 
symbol. The word Action is to the left of the command 
line. &CUR identifies the cursor position within the 
command line. Only one input field and only one &CUR 
are permitted per panel. &CUR is particularly useful for 
predefining a command in the input field. Without &CUR, 
the cursor defaults to the first position in the input field. 
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PF Key Prompts The 23rd and 24th lines of the panel indicate the function of 
specific PF keys: 

PF1 = HELP Displays the panel coded as 

HELP=helppan. 

PF2= END Exits to the originating component. 

PF3= RETURN Returns to the last panel from which 

a selection was made. 

PF4= TOP Displays the first page when you are 

in a multipage panel series. 

PF5 = BOTTOM Displays the last page when you are 

in a multipage panel series. 

PF6= ROLL Rolls to the screen of the previous 

active component. An operator can 
use ROLL to see the current panel in 
all active 5 NetView components. 

PF7= BACKWARD Returns to the previous page or 
panel in sequence. 

PF8= FORWARD Displays the next page when you are 

in a multipage panel series. 

PF11 = ENTRY POINT Shows the panel that the operator 
first saw upon entry to Help. 

Online Message Panel Naming Conventions 

The first message panel of a series of panels, or a message panel that has only one 
panel, is called the primary panel. The following conventions must be followed 
when naming an online message panel. Panel naming errors are returned when 
storing a panel using CNMSJ018 for MVS or CNMSV018 for VM if these conventions 
are not followed. The identifier for primary panels is the message ID with the action 
suffix omitted. For example, message ID DSI000I would have the primary panel 
named DSI000. Primary panel naming conventions are: 

• All names must contain six or seven characters 

• Characters 1 through 3 are alphabetic 

• Characters 4 through 6 (or 7) are numeric. 
For example, 

DSIGOO, BNJ1353, ABC1234 

When one panel cannot contain all the information required, you can use a continua- 
tion panel. The continuation panel name is the primary panel's name with an 
alphabetic suffix, A to X only. For example, DSI000A is the second in a series of 
panels for message ID DSI000. 

Note: The maximum number of panels in a panel hierarchy is 25. 

Before a continuation panel can be stored, a primary panel must exist. For 
example, panel DSI000 must exist before DSI000A can be added. An attempt to store 
DSI000B before DSI000A results in an error from CNMSJ018 (for MVS) or CNMSV018 (for 
VM). 
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Modifying Online Message Panels 

The technique for modifying online message panels is similar to regular help 
panels. However, you must first copy the panel record from the VSAM file 
(CNMMSGF) to a QSAM file. To do this: 

• ForMVS: 

- Use an editor such as ISPF/PDF to edit the CNMSJ017 sample. 

- Make sure the STEPLIB contains the proper data set name. 

- Enter the panel ID you want to copy into the SYSIN statement. Only one 
panel can be copied at a time. For example, enter DSI000A into the SYSIN 
statement to copy the second panel for message DSI000. 

- Submit the job. 

- When the copy is made, the panel requested is placed in a sequential data 
set named CNM.PANEL. 

- Error messages and successful completion messages are printed unless the 
JCL has been modified to redirect the output. Check the output designated 
by the JCL for error messages. 

• ForVM. 

- Invoke CNMSV017 with the panel ID to be copied as a parameter. For 
example, to copy the second panel for message DSIOOO enter: 

CNMSV017 DSIO0GA 

- When the copy is made, the panel requested is placed in a file named 
panel id PANEL. 

- Error messages and successful completion messages are printed unless the 
exec has been modified to redirect the output. 

CNMSV017 

has been modified to redirect the output. Check the output designated by 
the 

CNMSV017 

or error messages. 

Note: Any information following the panel identifier is considered a comment and is 
ignored during processing. 

When you have made your changes to the source panel, turn to "Storing New and 
Modified Panels" on page 43 and "Testing Newly Stored Panels" on page 44 to 
complete the modification procedure. 



Creating New Panels 



You may want to create a new panel to provide information for a new menu item, to 
add information to an existing flow of panels, or to have panel variables assigned by 
a command list and replaced with actual values. Another reason may be to provide 
help for a user-defined code point or for a command you have renamed with the 
CMDSYN parameter. See NetView Administration Reference for a description of the 
CMDSYN statement. 
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The general procedure for creating a new panel is to copy or create the source 
panel for it, type your data into the source panel, store it, and test it. 

Note: For MVS, if you want to modify or create a panel while the NetView program 
is running, define your panel data set without secondary extents. Otherwise, a 
panel might be filed in a new extent, and you would have to close and restart the 
NetView program to use the panel. For VM, if you want to modify or create a panel 
while the NetView program is running, you may need to reaccess the minidisk from 
the NetView USERID. 

Creating a Source Panel 

Before you create an entirely new source panel, try to locate an existing online help 
panel that is similar to the panel you want to create. Use the BROWSE command to 
search for such a panel. If you find one, copy it using a screen editor. 

If you have renamed a command, copy the panel that defined the original command. 

If you cannot find a similar online help panel, use a screen editor to build the source 
panel. Refer to Figure 10 on page 36 as a guide for creating the source panel. 

Naming a Source Panel 

Certain naming conventions apply to source panels that you create, and these must 
be adhered to. For message panels only, see "Modifying Online Message Panels" 
on page 39. Make sure your panel names do not conflict with IBM-supplied panel 
names. 

For any new panel, add one or more Rs to the panel name displayed on the screen 
(on the first line of the panel definition), so that the displayed name has at least nine 
characters. Since existing online help panel names have eight characters, the 
9-character name wilt help you identify panels you have created. 

If the HELP command list is to access the new panel, the first four letters of the panel 
name must be CNMK. Determine the remainder of the panel name as follows: 



• 



If the HELP command list is to process one operand, the first two and last two 
characters of the operand should follow CNMK. For example, the name for a 
help panel displayed for HELP APPLSACT would be CNMKAPCT. 

• If the HELP command list is to process two operands, the first two characters of 
each operand should follow CNMK. For example, the name for a help panel dis- 
played for HELP NETVIEW COMMANDS would be CNMKNECO. 

If the new panel is to replace an existing panel, the name of the new file must match 
the name of the existing file. 

If the new panel is to provide help for a renamed command, change the copied 
panel's name to reflect the new command name. Define the new name for the 
copied panel with the CMDSYN resource definition statement. 

Writing a Source Panel 

The instructions for structuring a new panel are the same as those for modifying an 
existing panel (see "Modifying a Source Panel" on page 35). In addition, you might 
need to change a command list or another panel that is affected by your new panel. 
Depending on how the new panel will be used, refer to one of the following sections: 

• If the new panel is to display variables assigned by a command list, see "Dis- 
playing Variables in Source Panels" on page 17. 
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• If the new panel is to be called by a command list, see Chapter 2, "Using the 
VIEW Command" on page 13. 

• If the new panel is to be a new menu option, see "Adding a Menu Item." 

• If the new panel is to be linked into a flow of two existing panels, see "Linking 
into an Existing Flow" on page 42. 

After you have written the new panel and made any other necessary changes, follow 
the instructions under "Storing New and Modified Panels" on page 43 and "Testing 
Newly Stored Panels" on page 44. 

Note: When coding Kanji on a help panel, you must enclose the Kanji characters 
with the shift-out (X'OE') and the shift-in (X'OF') on the same line. If the panel has 
more than one line containing Kanji text, code both the shift-out and shift-in on each 
line. 

Adding a Menu Item 

If the panel you create is to be a new menu item, add the name and description of 
the new panel to the source panel for the menu. For example, suppose Figure 11 is 
the existing panel to which you want to add a new menu option, V. 



/* 
/* 
/* 

HELP*CNM5HCCL 

A CNMKAPLS APPLS Command List 

8 CNMKAPCT 

C CNMKAPEN 

CNMKBFSE BFRUSE Command List 
£ CNMKCDMS CORM Command List 

F CNMKCDCS CDRSCS Command List 
G CNMKCLRS 
H CNMKDIIS 

1 CNMKDISG 
J CNMKDRTE 
K CNMKERST 
L CNMKLIES 
M CNMKMAES 
N CNMKNCOR 
CNMKNODE 
P CNMKPAHS 
Q CNMKPENG 
R CNMKSTNS 
S CNMKTEMS 
T CNMKTSER 
U CNHKVRST 
*** 

+CNH0CDMU 



\Se1ect+ 



%VTAM COMMAND LISTS TO DISPLAY NETWORK RESOURCES 



%A SAPPLS +appli cations 

%B $APPLSACT+active applications 

%C $APPLSPEN+pending applications 

%D $BFRUSE +buffer use 

%E $CDRMS +cross-domain resource mgrs %P $PATHS +paths 

%F SCDRSCS +cross-domain resources %Q SPENDING +pending nodes 

%G SCLSTRS +clusters *R $STATI0NS+1ink stations 



\Select+ 

*L ILINES +1ines 

%M SMAJHODES+major nodes 

%N $NCPST0R +NCP storage 

%0 SNODE +any node 



%H $DIS +disp!ay any resource %S 

hi $DISG +disp1ay route graphics %T 

*J SDROUTE +routes %U 

%K $ERST +explicit route status 



$TERMS +teminals 

STSOUSER +TS0 users <MVS only) 

$VRST +virtua1 route status 



+Type a letter (A through U) and press ENTER. 

$ 

%Action*«>~&CUR 

$ PF1« Help PF2« End PF3« Return J>F4« Top PF5« Bottom 

$ PF6* Roll PF7« Backward PF8* Forward $PF11» Entry Point 



Figure 11. Source Panel with a Menu 
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To make your new panel the last menu option in Figure 11, do the following (the 
referenced additions are reflected in Figure 12 on page 42): 

Add an option definition to the list of options. 
Add an R to the name of the panel displayed on the screen. 
Add the panel name, letter key, and description to the menu selections. 
Add the letter key V to the action options. 
Make adjustments to maintain 24 or fewer lines of displayable text. 



/*' ■ ■ 

/* ■■• 
/* 

HELP-CNM5HCCL 

A CNMKAPLS APPLS Command List 

B CNMKAPCT 

C CNMKAPEfc 

CNMKBFSE BFRUSE Command List 
E CNMKCOMS CDRM Command List 

F CNMKCDCS CDRSCS Command List 
6 CNMKCLRS 
H CNMKDIIS 

1 CNMKDrSS 
J CNMKDRTE 
K CNMKERST 
L CNMKLIES 
M CNMKMAES 
N CNMKNCOR 
CNMKNOOE 
P CNWCPAHS 
Q CNMKPEN6 
R CNMKSTKS 
S CNMKTEMS 

CNMKTSER 
CW«VRST 

cnmkvterO 



cnmocdmur|| 

\Se1ect* 



%VTAM COMMAND LISTS TO DISPLAY NETWORK RESOURCES 



%A $APPLS +applications 

%B $APPLSACT+active applications 

%C SAPPLSPEN+pending applications 

%D SBFRUSE +buffer use 



\Select+ 

%L SLINES +1ines 

%M $MAJNODES+major nodes 

%M $NCPST0R +NCP storage 

%0 $N0DE +any node 



%E SCDRMS +cross-domain resource mgrs %P 
%F $CDRSCS +cross-domain resources %Q 
%6 SCLSTRS +clusters %R 



SPATHS +paths 
SPENDING spending nodes 
$STATI0NS+1ink stations 

$TERMS +terminals 
STSOUSER +TS0 users (MVS only) 
$VRST +virtual route status 
SVTAMUSER-Hiser Command List|| 

♦Type a letter (A through V) and press ENTER. Q 

%Action*«>~&CUR 

PF1» Help PF2» End PF3= Return PF4- Top PF5* Bottom 
PF6* Roll PF7» Bacicward PF8* Forward $PF11* Entry Point 



%H 


$DIS 


♦display any resource 


%S 


%I 


SDISS 


♦display route graphics 


%T 


%J 


SDROUTE 


♦routes 


%U 


%K 


$ERST 


♦explicit route status 


%V 



Figure 12. Source Panel with a New Menu Item 

Create the panel for this new item and name it CNMKVTER. Then save the altered 
menu with the name CNMOCDMU. 

Linking into an Existing Flow 

To insert a newly created panel into a flow of two existing panels, modify the list of 
options in the top left corner of the source panels. For example, if panels A and B 
are part of an existing flow and C is a new panel that belongs in the flow, add panel 
C to source panel B's list of panel options. 

Figure 13 on page 43 represents the existing flow of two panels, and Figure 14 on 
page 43 represents the revised flow after the addition of a new panel. In the 
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figures, CNMKDRTE represents panel Q , CNM0CDR1 represents panel Q , and 
CMN0CDR2 represents panel Q . 



CNM0CDR1 OROUTE COMMAND LIST SAMPLE 

*** 

+CNMK0RTE *DR0UTE COMMAND LIST DESCRIPTION +Page 1 of 2 

"$ 



f +CNMOCDR1 *DR0UTE COMMAND LIST SAMPLE +Page 2 of 2 

Figure 13. Action Options of Panels in an Existing Flow 

Figure 14 shows the revised action options of each panel in the new flow after the 
addition of the new panel. 

D 

CNMOCDRl OROUTE COMMAND LIST SAMPLE 

*** 

+CNMKDRTER VDROUTE COMMAND LIST DESCRIPTION +Page 1 of 3 
$ 



CNM0C0R2 OROUTE COMMAND LIST SAMPLE CONT. 

*** 

+CNM0CDR1R *DR0UTE COMMAND LIST SAMPLE +Page 2 of 3 

$ % __ 

B 

+CNM0CDR2R %DR0UTE COMMAND LIST SAMPLE CONT. +Page 3 of 3 

Figure 14. Action Options of Panels in a New Flow 

In Figure 14, notice how the option definitions have been rearranged. The option 
definition of the first panel still points to the second panel. But the option definition 
of the second panel now points to a new continuation panel. This new continuation 
panel has no option definitions since it is the last panel in the sequence. 

Two other changes are necessary. Change the page numbers, as shown in 
Figure 14, to reflect three pages instead of two. Change the panel names in the 
upper left corner of the displayed panel by adding as many Rs to the end of the 
name as necessary to make the displayed name nine characters long. This distin- 
guishes the modified panels from the unmodified panels. 



Storing New and Modified Panels 



Store the panels you modify or create in the data set concatenated to the front of 
DDNAME CNMPNL1 (for MVS) or in a file with filetype NCCFLST (for VM). Panel data 
streams are limited to 9600 bytes. 

For online message panels, you can either store them as described above or add or 
replace panels directly to the VSAM file (CNMMSGF). To store panels directly on the 
VSAM file: 
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• ForMVS: 

- Edit the CNMSJ018 sample. 

- Make sure the STEPLIB contains the proper data set name. 

- Make sure the CNMSEQ OD statement specifies the proper sequential data 
set name. 

- Enter the panel ID you want to store into the SYSIN statement. Only one 
panel can be stored at a time. For example, enter DSI000A into the SYSIN 
statement to store the second panel for message DSI000. 

- Submit the job. 

- When the store is successful, a message is generated indicating successful 
completion. 

- Error messages and successful completion messages are printed unless the 
JCL has been modified to redirect the output. Check the output designated 
by the JCL for error messages. 

• ForVM: 

- The panel to be stored must have a filename the same as the panel name, 
have a filetype of "panel," and exist on the A-disk. 

- The STATMON LOADLIB must be accessible. 

- The VSAM DOS disk must be linked in read/write mode. The default device 
address is 198. If this is not true for your installation, you should modify 
CNMSV018 to reflect the correct device address. 

- Invoke CNMSV018 with the panel ID to be stored as a parameter. For 
example, to store the second panel for message DSIOOO enter: 

CNMSV018 DSIOGGA 

- When the store is successful, a message is generated indicating successful 
completion. 

- Error messages and successful completion messages are printed unless the 
exec has been modified to redirect the output. Check the output designated 
by the exec for error messages. 

Any information following the panel identifier is considered a comment and is 
ignored during processing. Panel naming conventions can be found in "Modifying 
Online Message Panels" on page 39. We suggest you retain copies of any message 
help panels that you add or modify. 



Testing Newly Stored Panels 



After storing modified or new panels, call each panel and verify that it displays the 
proper information. To view the panel, enter: 

TUTOR panel _name 

where panel_name is the name of the appropriate source panel. 

If the displayed panel contains errors, modify it, store it, and test it again. If a panel 
is missing, a CNMxxxl message is displayed with a return code and an explanation 
of that return code. Refer to Table 7 on page 32. 
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Chapter 4. Customizing Hardware Monitor Displayed Data 

This chapter describes how to modify generic and pregeneric alerts. In previous 
releases of the NetView program, Recommended Action panels, Event Detail 
panels, and alert messages were stored at the host. Each pregeneric alert had a 
unique set of panels and messages. With generic alerts, coded information is con- 
tained in the alert and this information (generic alert code points) is used to dynam- 
ically build the hardware monitor panels. 

This chapter tells how to: 

• Modify the text of pregeneric Recommended Action and Event Detail panels 

• Modify pregeneric alert messages 

• Overlay Recommended Action numbers from a generic alert 

• How to control the use of color and highlighting for hardware monitor panels 

• Use NMVT support for user-written programs including: 

- a sample generic alert and its associated hardware monitor panels 

- creating user-defined generic code points 

- adding additional resource types to the hardware monitor. 

Note: If your panels or alert messages have been translated into Japanese (using 
Kanji), exercise great care to preserve the integrity of the double byte character set 
strings. 

Modifying Hardware Monitor Panels 

Recommended Action panels and Event Detail panels are defined for event condi- 
tions that are not based on generic alert records. If several event conditions use the 
same Recommended Action panel or Event Detail panel, the panel is physically 
defined under a single name, the actual panel name. Any other name under which 
the actual panel may be displayed is the panel alias. Determining whether the 
panel name is an actual name or an alias is the first step in modifying panel text. 

• Changes you make to an actual panel text (and name) are reflected in all its 
aliases. 

• Changes you make to a panel alias (or name) cause a new actual panel (and 
name) to be created under the name that was formerly the alias name. 

Determining Panel Name, Actual versus Alias 

To determine a panel's name and whether it is an actual panel name or an alias, 
follow these steps: 

You must first determine the event associated with the text you want to change, then 
identify a resource for which the event has been logged. For example, 

1. For the identified resource, display the Alerts-Static, Alerts-History, or Most 
Recent Events panel. 

2. Enter sel# C, where se/# is the selection number on the panel of the event asso- 
ciated with the text you want to change. 

3. Examine the 5-digit code, xxxyy, that the NetView program returns. 

xxx is the NetView-designated product code, or block ID, for the resource. 

(Block IDS are listed in NetView Problem Determination and Diagnosis.) 
yy is an individual panel identifier. 
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Note: If you get a PRODUCT ID and ALERT ID instead of a 5-digit code, the asso- 
ciated record is a generic alert. Generic alerts do not have unique prestored 
panels in the hardware monitor. See "Using NMVT Support for User-Written 
Programming" on page 60 for more information on generic alerts. 

4. Determine which panel contains the text you want to change, as follows: 

• For a Recommended Action panel, the panel name (or panel alias) is 
BNlxxxyy, where xxx and yy are the codes you identified in step 4. 

• For an Event Detail panel, the panel name (or panel alias) is BNKxxxyy, 
where xxx and yy are the codes you identified in step 4. 

5. Now determine whether BNlxxxyy or BNKxxxyy is an actual or alias panel name 
as follows: 

• ForMVS: 

- Use an editor such as ISPF/PDF to examine the directory listing of panel 
names. This listing is in the IBM-supplied partitioned data set (PDS) 
named SYS1.BNJPNL1. The word alias appears to the right of those 
panel names that are aliases. 

• ForVM: 

- Check the VM file list for the panel name. The filename is the same as 
the panel name, and the filetype is NCCFLST. If the panel name is an 
alias, it will not appear in the file list. 

- Use an editor such as XEDIT to examine the CSECT BNJBLKID file type 
ASSEMBLE. This lists the block IDS whose Recommended Action panels 
and Event Detail panels have at least one alias. (A sample BNJBLKID 
table is shown in Figure 15 on page 47.) If block ID xxx is on the list, 
check CSECT BNJALxxx filetype ASSEMBLE, which lists all aliases for 
block ID xxx, to determine whether BNlxxxyy or BNKxxxyy is an alias for 
some other panel name. (A sample BNJALxxx table is shown in 
Figure 16 on page 48.) 

6. Go to the appropriate section, "Changing Panel Text" on page 48, "Changing 
From Alias to Actual" on page 49, "Deleting an Actual or Alias" on page 49, or 
"Adding an Actual or Alias" on page 50. 
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TITLE 'BNJBLKID: LIST OF ALIAS TABLES BY BLOCK ID' 



BNJBLKID CSECT 




EJECT 




DS 


OF 


NUMENT DC 


AL4((TABI 


TABSTART EQU 


* 


DC 


CL3'FED' 


DC 


CL3'FEE' 


DC 


CL3'FEF' 


DC 


CL3'FE1' 


OC 


CL3'FE2' 


DC 


CL3TE3' 


DC 


CL3'FE4' 


DC 


CL3'FFD' 


DC 


CL3'FFE' 


DC 


CL3TFF' 


DC 


CL3'FF2' 


DC 


CL3'FF5' 


DC 


CL3'FF6' 


DC 


CL3'FF7' 


DC 


CL3'FF8' 


DC 


CL3'FF9' 


DC 


CL3'005' 


DC 


CL3'016' 


DC 


CL3-017' 


DC 


CL3'02D' 


DC 


CL3'021' 


DC 


CL3'022' 


DC 


CL3'023' 


DC 


CL3'03E' 


DC 


CL3'036' 


DC 


CL3'04A' 


DC 


CL3'04B' 


DC 


CL3'04C 


DC 


CL3'04D' 


DC 


CL3'04E' 


DC 


CL3'04F' 


DC 


CL3'043' 


DC 


CL3'044' 


DC 


CL3'047' 


DC 


CL3'049' 


TABEND EQU 


* 


LENG EQU 3 


END BNJBLKID 



NO. OF ENTRIES 



ENTRY BYTE LENGTH 



Figure 15. Sample BNJBLKID Table 



Chapter 4. Customizing Hardware Monitor Displayed Data 47 



TITLE 'BNJAL036: ALIAS TABLE FOR BLOCKID 036 
BNJAL036 CSECT 
EJECT 
DS OF 

DC AL4((TABEND-TABSTART)/LENG) 
REAL NAME ALIAS NAME 



NUMENT 



NO. OF PAIRS 



TABSTART 



TABEND 
LEN6 



EQU 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

DC 

EQU * 

EQU 16 

END BNJAL036 



CL8'BNIG3609' ,CL8'BNI0366D' 

CLS'BNioseos'.CLS'BNioseec' 

CL8'BNI03607' .CLS'BNIOSeeB' 
CL8'BNI036O6' ,CL8'BNI0366A' 

CLS'BNioseos'.cLS'BNioseeg' 

CLS'BNIOSeOS'.CLS'BNIOSe?!' 
CL8'BNI03605' ,CL8'BNIO360D' 

CLS'BNioseor.as'BNioseea' 
cl8 ' bni03604 ' , cl8 ' bnig3670 ' 
cl8 , bnio3604',cl8 , bnio36oc 
cl8'bnig3603* ,cl8' bnig3667' 
CLS'BNiGseoa'.CLS'BNiGseee' 
CLS'BNioseoi'.as'BNiosees 1 

CLS'BNIOSeOB'.CLS'BNIOSeeF 1 
CLS'BNIOSeOA'.CLS'BNIOSeeE' 
CL8 ' BNK036O9 * , CL8 ' BNKG366D ' 
CL8 ' BNK036O8 ' , CL8 ' BNK0366C ' 
CL8 ' BNK036O7 ' , CL8 ' BNKG366B ' 
CL8 ' BNK03606 ' , CL8 ' BNKG366A ' 
CL8 ' BNK03605 ' , CL8 ' BNK03669 ' 
CL8 ' BNK03604 ' , CL8 ' BNK03668 ' 
CL8 ' BNK036O3 ' , CL8 ' BNK03667 ' 
CL8 ' BNK03602 ' , CL8 ' BNKG3666 ' 
CL8'BNK0360r .CLS'BNKGSeeS" 
CLS'BNKOSeOD'.CLS'BNKGSe?!' 
CL8 ' BNK0360C ' , CL8 ' BNK03670 ' 
CL8 ' BNK0360B ' , CL8 ' BNK0366F ' 
CL8 ' BNK0360A ' , CL8 ' BNK0366E ' 



ENTRY PAIR BYTE LENGTH 



Figure 16. Sample BNJALxxx Table 



Changing Panel Text 

If BNlxxxyy or BNKxxxyy is an actual panel name (not an alias), follow these steps to 
change the panel wording. 

• ForMVS: 

1. Use an editor such as ISPF/PDF to edit the PDS member containing the 
panel. The PDS name is SYS1.BNJPNL1 (unless it was changed during instal- 
lation), and the member name is the same as the panel name. 

2. Save the changed member. 



1 Do not alter the number of noncomment lines. BNlxxxyy panels must contain exactly 14 noncomment lines; BNKxxxyy panels must 
contain exactly 7 noncomment lines. Comment lines contain an asterisk (*) in column 1. 
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• ForVM: 

1. Use an editor such as XEDIT to edit the CMS file containing the panel. The 
filename is the same as the panel name and the filetype is NCCFLST. 

2. Save the changed file. 

The changes you have made will now apply to all event conditions that use the 
panel or any of its aliases. 

Changing From Alias to Actual 

If you want to make a panel that now appears under an alias name into an actual 
panel, follow these steps: 

Note: For more information on MVS utilities, see MVS I Extended Architecture Data 
Administration: Utilities. For more information on JCL see MVS I Extended Architec- 
ture Job Control Language User's Guide. 

• For MVS: 

1. Use an editor such as ISPF/PDF to edit the PDS member containing the panel 
alias. The PDS name is SYS1.BNJPNL1 (unless it was changed during instal- 
lation), and the alias member name is the same as the panel name. 

2. Save the changed member. TSO will convert the panel alias into an actual 
panel. 

• ForVM: 

1. Find out if BNIxxxyy or BNKxxxyy is the only alias for block ID xxx. If it is: 

a. Erase the CSECT table BNJALxxx filetype ASSEMBLE. 

b. Delete the block ID entry from the table BNJBLKID filetype ASSEMBLE. 

c. Assemble and relink BNJBLKID. 

If BNIxxxyy or BNKxxxyy is not the only alias for block ID xxx: 

a. Erase the alias entry from CSECT table BNJALxxx. 

b. Assemble and relink BNJALxxx. 

2. Create a CMS file with filename BNIxxxyy or BNKxxxyy and filetype NCCFLST, 
by copying the file from the actual panel for which BNIxxxyy or BNKxxxyy was 
an alias. 

3. Use XEDIT to make the desired changes to the new file. 

4. Save the changed file. 

A new actual panel has now been created under the name that was formerly the 
alias name. 

Deleting an Actual or Alias 

To delete an actual or alias panel name: 

• For MVS, either: 

— Delete the PDS member containing the actual or alias panel name. The PDS 
name is SYS1.BNJPNL1 (unless it was changed during installation), and the 
member name is the same as the panel name. 

- Use the utility IEHPROGM. For example, to delete aliases BNK04B2E and 
BNK04B2F using this utility, you might code the following: 
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//DELMEBR2 JOB MSGLEVEL=(1,1) 

//STEP1 EXEC PGM=IEHPROGM 

//SYS PRINT DD SYSOUT=A 

//DS1 DO VOL=SER=vsnum,DISP=SHR,UNIT==device_type 

//SYS IN DD * 

SCRATCH VOL=device_type=vsnum,DSNAME=panel_dsname, 
MEMBER=BNK04B2E 
//STEP2 EXEC PGM=IEHPROGM 
//SYSPRINT DD SYSOUT=A 

//DS1 DD VOL=SER=vsnum,DISP=SHR,UNIT=device_type 
//SYS IN DD * 

SCRATCH VOL=device_type=vsnum,DSNAME=panel_dsname, 
MEMBER=BNK04B2F 
/* 

In this example, devicejype is the device type, vsnum is the volume serial 
number on which the data set resides, and panel jdsname is the name of the 
data set containing the panels. For more information on MVS utilities, see 
MVS/Extended Architecture Data Administration: Utilities. For more infor- 
mation on JCL, see MVS/Extended Architecture Job Control Language 
User's Guide. 

• ForVM: 

- To delete an actual panel name, erase the CMS file containing the panel you 
want to delete. The filename is BNlxxxyy or BNKxxxyy, and the filetype is 
NCCFLST. 

- To delete an alias panel name: 

- If BNlxxxyy or BNKxxxyy is the only alias for block ID xxx: 

1 . Erase the CSECT table BNJALxxx filetype ASSEMBLE. 

2. Delete the block ID entry from table BNJBLKID filetype ASSEMBLE. 

3. Assemble and relink BNJBLKID. 

- >"f BNlxxxyy or BNKxxxyy is not the only alias for block ID xxx: 

1. Delete the alias name from tabie BNJALxxx. 

2. Assemble and relink BNJALxxx. 

Adding an Actual or Alias 

If you want BNlxxxyy or BNKxxxyy to be a new (or replacement) panel name or alias, 
follow these steps: 

Note: For more information on MVS utilities, see MVS/Extended Architecture Data 
Administration: Utilities. For more information on JCL see MVS/Extended Architec- 
ture Job Control Language User's Guide. 

• For MVS, either: 

- Add an actual panel (and name) {not an alias), using an editor such as 
ISPF/PDF to copy an existing panel that is similar to the desired one. Then 
make the required changes to the new panel. 

- Add either an actual panel or an alias, using the utility IEBUPDTE. For 
example, to add BNK04B2E as an alias of BNK04B2A using this utility, you 
might code the following: 
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//PANELS JOB MSGLEVEL=1,MSGCLASS=A 

//UPDATE1 EXEC PGM=IEBUPDTE,PARM=NEW 

//SYSPRINT DD SYSOUT=A 

//SYSUT2 DD DSN=panel_dsname,DISP=SHR,UNIT=device_type, 

// VOL=SER=vsnum 

//SYS IN DD * 

./ ADD NAME=BNK04B2A 

DETAIL DESCRIPTION: THE ERROR ANALYSIS MICROCODE 

HAS DETECTED AN INVALID ERROR LOG ENTRY. 



LOG ENTRY 0-3 4-7 8-11 

**************************************************** 



***************L^jj LINE OF PDS MEMBER************ 

./ ALIAS NAME=BNK04B2E 

/* 

In this sample, panel jdsname is the name of the data set where the panel is 
stored, and vsnum is the volume serial number on which the data set 
resides. Although the sample defines only one new alias, up to 15 are 
allowed. For more information on MVS utilities, see MVS I Extended Archi- 
tecture Data Administration: Utilities. For more information on JCL, see 
MVS/Extended Architecture Job Control Language User's Guide. 



• ForVM: 



To add a panel (and name), create a CMS file with filename BNlxxxyy or 
BNKxxxyy, and filetype NCCFLST. Insert the comments and noncomment text 
that you want. Alternatively, you can copy an existing file that is similar to 
the desired one and make the required changes to the new file. 

To add a panel alias: 

- If block ID xxx exists in CSECT BNKBLKID filetype ASSEMBLE: 

1. Add an alias entry for BNlxxxyy or BNKxxxyy in CSECT BNJALxxx 
filetype ASSEMBLE, following the format in the sample table, 
BNJAL036, shown in Figure 16 on page 48. 

2. Assemble and relink CSECT BNJALxxx. 

- If block ID xxx does not exist in CSECT BNKBLKID: 

1. Add block ID xxx to CSECT BNJBLKID. 

2. Assemble and relink CSECT BNJBLKID. 

3. Create CSECT BNJALxxx with an entry for alias BNlxxxyy or 
BNKxxxyy, following the format in the sample table, BNJAL036, 
shown in Figure 16 on page 48. 

4. Assemble and relink CSECT BNJALxxx. 
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Alert Messages 



To change the EVENT DESCRlPTION:PROBABLE CAUSE text of any selection on an 
Alerts-Static, Alerts-History, Alerts-Dynamic, Event Detail, or Most Recent Events 
panel that is not associated with generic alerts, follow these steps: 

1. For the text you want to change, determine its associated event and identify a 
resource that the event has been logged against. 

2. For the resource you identified in step 1, display the Alerts-Static, Alerts-History, 
Alerts-Dynamic, Event Detail, or Most Recent Events panel. 

3. Enter sel# C, where se/# is the selection number of the event associated with 
the text you want to change. 

4. Examine the 5-digit code, xxxyy, that the NetView program returns. 

xxx is the NetView-designated product code, or block ID, for the resource. 

(Block ID s are listed in NetView Problem Determination and Diagnosis.) 
yy is an individual panel identifier. 

Note: If you get a PRODUCT ID and ALERT ID instead of a 5-digit code, the asso- 
ciated record is a generic alert. Generic alerts do not have unique prestored 
EVENT DESCRlPTlON:PROBABLE CAUSE text messages in the hardware monitor. 
See "Using NMVT Support for User-Written Programming" on page 60 for more 
information on generic alerts. 

5. Use an editor such as ISPF/PDF (for MVS) or XEDIT (for VM) to retrieve and edit 
the CSECT that contains the text you want to change. The name of the CSECT is 
BNJVMxxx (for MVS, PDS member in SYS1.BNJSRC1, for VM, filetype ASSEMBLE) 
where xxx is the block ID you identified in step 4. 

6. Locate the message text within BNJVMxxx. The message number for this text is 
the decimal equivalent of yy, where yy is the hexadecimal identifier you deter- 
mined in step 4. 

7. Change the assembler language macro DSIMDS for the text you want to change. 
For the syntax of DSIMDS, see NetView Customization: Using Assembler. 

8. Save the changed CSECT. 

9. Reassemble the CSECT, and link-edit it into the load module of the same name. 



Overlaying Recommended Action Numbers 



Recommended Action numbers (Ennn and \nnn) displayed from a generic alert can 
be overlayed with a different number. This section tells how to overlay default 
generic alert l-numbers and E-numbers on hardware monitor Recommended Action 
panels with sending product-unique action numbers. 

On Recommended Action panels of the hardware monitor, each recommended 
action is identified with a special action number. Figure 17 on page 53 shows a 
sample Recommended Action panel with three recommended actions (D225, D001, 
and D238). 
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H £ T V I E W SESSION DOMAIN: CNM81 OPER1 81/02/89 14:48:53 
PDA-45A ...;; ^ *J8EC0MMENDED ACTION FOR SELECTED £¥ENT * .... .i *A6E 1 OF 



DOMAIN 



COMC 



-LINE— -I CTRL 



USER CAUSED - LSL 2 REMOTE OSU/CSU IN TEST NODE 

tSL 2 REMOTE DSU/CSU IN CONFIGURATION WOE 
LINE SWITCHED TO INCORRECT POSITION 
ACTIONS - D801 - CORRECT THEN RETRY 

INSTALL CAUSED - LSL 2 REMOTE DSU/CSU ADDRESS INCORRECT 
LSL 2 DSU/CSU' S SPEED MISMATCH 
PHYSICAL LINE CONNECTIONS 
ACTIONS - 0225 - CORRECT ADDRESS FROM DSU/CSU CONTROL PANEL 
0001 - CORRECT THEN RETRY 
D238 - PERFORM REMOTE DSU/CSU PROBLEM DETERMINATION 

ENTER ST (MOST RECENT STATISTICS), DM (DETAIL MENU), OR D (EVENT DETAIL) 

|;CMD*«> 

Figure 17. Recommended Action Panel for Selected Event 

The ACTION command list may be used to get more information on a recommended 
action displayed in the hardware monitor. See Chapter 3, "Modifying and Creating 
Online Panel Interfaces" on page 35 for information on how to modify the help 
panels displayed by use of the ACTION command list. Dnnn, Ennn, and \nnn are 
recommended action numbers found on the Recommended Action panels. The fol- 
lowing describes what would be displayed by the ACTION command list for the dif- 
ferent recommended action numbers: 

ACTION Dnnn Displays an IBM-supplied, detailed description of a recommended 

action. 
ACTION Ennn Displays a detailed description of a recommended action created by 

your system programmer for a user-defined generic alert action. 
ACTION Innn Displays a detailed description of a recommended action created by 

your system programmer for an IBM-defined generic alert action. 

Because details of a particular generic alert Recommended Action may vary 
depending on the sending product, action number panels cannot be provided for all 
possible generic actions. Therefore, on NetView Recommended Action panels built 
for generic alerts, each recommended action is preceded by an l-number 
(IBM-supplied action) or an E-number (user-supplied action). 

l-number and E-number actions do not have NetView-supplied panels associated 
with them. However, the NetView program allows users to overlay l/E-numbers with 
action numbers to create panels that are specific to the sending product. This is 
done by modifying table BNJDNUMB in SYS1.BNJPNL2 (for MVS) or BNJDNUMB 
NCCFLST * (for VM) and creating BHJwwwww PDS members (MVS) or BHJwwwww 
NCCFLST * files (VM) (the * denotes filemode). In the rest of this section, BNJDNUMB 
and BNJwwwww refer to a PDS member for MVS and to a CMS file, filetype NCCFLST, 
for VM. 
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User Interfaces 



BNJDNUMB 



BIMJDNUMB correlates a product-set identification (PSIO) with a unique file or PDS 
member (BNJwwwww) that contains the action numbers to use for this product. To 
modify BNJDNUMB, use an editor such as ISPF/PDF (for MVS) or XEDIT (for VM). 

Note: If the NetView program receives a generic alert whose PSID does not exist in 
BNJDNUMB, the default l-number or E-number is not modified. 



The format for BNJDNUMB is: 

xxx 

yyyyyyyyy bnjwwvww 

yyyyyyyyy bnjwwwww 



comment 
comment 



The symbol definitions are: 

xxx The number of entries in BNJDNUMB. This entry must begin in 

column 1 (three characters with leading zeros). 

yyyyyyyyy Up to nine characters representing the PSID. This entry must begin in 
column 1. 

BNJwwwww The name of the PDS member (MVS) or file (VM), beginning in 

column 11, that contains generic alert recommended action code 
points and associated action numbers. Names such as BNJDNUM2, 
BNJDNUM3, and so forth, are recommended; however, any unique 
name can be used. BNJDNUM1 is already used for generic alerts 
produced by the hardware monitor. 

Entries in BNJDNUMB must be in ascending order. Comment lines contain an 
asterisk (*) in column 1. The first line cannot be a comment line. Figure 18 shows 
a sample of BNJDNUMB provided by the NetView program. The 7-character NetView 
PSlDs for the various operating systems all map to BNJDNUM1, the action number 
file or PDS member used by the NetView program. 



003 






5664204 


BNJ0NUM1 


NETVIEW R3 VM 


5665361 


BNJDNUM1 


NETVIEW R2 MVS/370 


5665362 


BNJDNUM1 


NETVIEW R3 MVS/XA 



Figure 18. Sample BNJDNUMB 

Determining the PSID: Because the sending product can be either a hardware 
product or a software product, the PSID is defined as follows: 

• For hardware products, the PSID is defined with the four numeric characters 
identifying the machine type found in the X'OO' subfield, Hardware Product 
Identifier (located in the first X' 11' subvectorof the first X' 10' subvector in the 
generic alert). 

• For software products, the PSID is defined with the nine uppercase alphameric 
characters of the serviceable component identifier in the X' 02' subfield, Soft- 
ware Product Serviceable Component Identifier (located in the first X' 11 ' sub- 
vector of the first X' 10' subvector in the generic alert). 

Note: If the X'02 1 subvector does not exist, use the seven uppercase alpha- 
meric characters of the program product number in the X'08' subvector, Soft- 
ware Product Program Number (located in the first X' 11 ' subvector of the first 
X'10' subvector in the generic alert). 
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BNJwwwww 



Two methods are available to determine the PSID of a generic alert that has been 
logged to the hardware monitor data base. 

1. Select sell C from Alerts Static, Alerts History, or Most Recent Events panels to 
display a message containing the PSID. 

2. The sending PSID is also displayed on page 1 of the PSID panel. This panel can 
be reached by a selection from the Event Detail Menu. 



Each BNJwwwww contains generic alert recommended action code points and asso- 
ciated action numbers. To create the BNJwwwww files/members specified in table 
BNJDNUMB, use an editor such as ISPF/PDF (for MVS) or XEDIT (for VM). For MVS, 
each BNJwwwww PDS member should be stored in the first data set in the concat- 
enation string for the DD statement BNJPNL2. This DD statement is in the NetView 
startup procedure. For VM, each BNJwwwww file should be stored on a minidisk 
accessed by the NetView virtual machine. 

For MVS, if you want to modify or create a panel while the NetView program is 
running, define your panel data set without secondary extents. Otherwise, a panel 
might be filed in a new extent, and you would have to close and restart the NetView 
program to use this panel. 

Following is the format for BNJwwwww. 



xxxx 


yyyyyyyy 


dnum 


xxxx 


yyyyyyyy 


dnum 


xxxx 


yyyyyyyy 


dnum 



The symbols are defined as follows: 

xxxx The 4-character generic alert recommended action code point (the 

EBCDIC version of the recommended action code point as defined by 
the generic alert architecture). This field must begin in column 1. 

yyyyyyyy The 8-character alert ID number (EBCDIC version of the alert id number 
as defined in the X'92' subvector architecture ). This field is optional, 
but, if present, must begin in column 11. 

dnum The 4-character unique action number. This field begins in column 21. 

Action numbers can be any combination of four EBCDIC characters. 
The limiting factor of the action number is the ability of the ACTION 
command list to use these four characters and to display the associ- 
ated panel. 

Entries in each BNJwwwww file/member must be in ascending hexadecimal order. If 
an invalid (nonhexadecimal) number is used, it will be skipped over. 

The BNJwwwww file/member specified in BNJDNUMB for the alert sender will be 
searched serially until a match is found or the end of the file is reached. Once the 
first * is found in column 1, the serial searching stops. 

Blanks could be placed in the alert ID field, along with specific alert IDs, for a partic- 
ular action code point. Figure 19 shows a sample BNJwwwww user-defined table. 



10G2 




D562 


10G2 


93987791 


D890 


10G2 


D2556B79 


D777 



Figure 19. Sample BNJwwwww User-Defined Table 
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For alert D2556B79, the code point 1002 uses D777 as its action number. For alert 
93987791, code point 1002 uses 0890 as its action number. For all other alerts from 
this sending product, code point 1002 uses D562 as its action number. 



Color and Highlighting 



For the hardware monitor displays, you can alter the color, highlighting, and inten- 
sity of the display's text. You can also cause the display to produce an audible 
alarm. Consider the needs of the display users, though, before you modify these 
four attributes as assigned by the NetView program. 

Note: You should not change any attribute's length, row placement, or column 
placement, since the results are unpredictable. 

For any string of display text that is preceded by a blank, you can modify up to four 
attributes: 

Attribute Meaning 

Color Text appears red, yellow, blue, white, green, turquoise, or pink. 

Highlighting Text is shown underscored, blinking, or in reverse video. 

Intensity Text appears more intense (on monochrome terminals only). 

Alarm Text causes an audible alarm at the user's terminal. 

You can change these attributes for specific displays or for all displays. For 
example, you could select a single color for prompt lines on all displays. 

The procedure for modifying these attributes begins with a color map. A color map 
is a table that causes characters representing the various attributes to be imbedded 
in a color buffer. These characters in the color buffer control the appearance of the 
display. 

Selecting the Color Map 

The first step in modifying a hardware monitor display is to determine which color 
map controls the display you want to change. Appendix A, "Color Maps for Hard- 
ware Monitor Panels" on page 79 contains a matrix of the display name, display 
number, and color map for hardware monitor displays. 

After you have identified the color map you need, edit it using an editor such as ISPF 
(for MVS) or XEDIT (for VM). For MVS, the color maps are contained in the PDS 
named SYS1.BNJPNL2 (unless the name was changed during installation); the 
member name is the color map name. For VM, the file name is the color map name 
and the file type is NCCFLST. 

Note: If you want a particular attribute to apply to the same portion of all displays, 
create color map BNJOVERW, which overwrites all other display-specific color maps. 
Be sure to test the results of BNJOVERW on all displays before putting it into your 
production system. This map may produce unexpected results. 
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Modifying the Color Map 

After selecting the color map, you can modify it. A color map consists of a series of 
lines of data, called map elements. The top line of a color map is always the 
number of subsequent map elements. Map elements begin in column 1 and are 
paired with comments that begin in column 41. 

Each map element specifies, for a particular display row, the attribute, the 
attribute's placement in the row, and the length in characters. Each item in the map 
is followed by a comma except for the last one, which is followed by a period. 

Note: You should not change any attribute's length, row placement, or column 
placement, since the results are unpredictable. 

Figure 20 shows a sample color map. The numerical references are explained on 
pages 57 - 59. 



i3. a 




NUMBER OF ELEMENTS IN TABLE 


1.1.1.79.BLU.S 




NETVIEW HEADER 


1,2.1. 14, BLU. 




SCRN ID 


2.2.16.64.HIG.WHI. 




SCRN TITLE 


1.3. 1.7. BLU, 




DOMAIN 


1.3.9.71.TUR. 






1,5, 1,79. BLU. 




HEADING 


99,SIZE-0-7,2.H 




REPETITION 


2.6.1.4.HI6.WHI. 




SEL # 


1,6.6,74,TUR, 




DATA 


1.SIZE-4.1.50.BLU. 


D 


PROMPT LINE 


2,SIZE-4,52,1,HIG,WHI, 


PROMPT LINE 


1.SIZE-4.54.26.BLU 


, 


PROMPT LINE 


l t SIZE-3.1,79,BLU. 




PROMPT LINE 



Figure 20. Sample Color Map 

The components of a color map, illustrated in Figure 20, are as follows: 

Q The first item in the color map must be the number of subsequent lines of data, 
or map elements, in the map. A map can have any number of map elements. The 
sample map has 13 map elements. 

H , H and Q illustrate the three types of map elements, which are described 
below: 

Q This type of map element contains attribute information in the following format: 

• The first item is the number of attributes in the map element. This number can 
be from one to four. A map element can have just one attribute such as pink 
color or any combination, such as pink color and underscoring. The sample 
map element has one attribute, blue color (BLU). 



• 



The second item is the number of the display row that is to reflect the attribute. 
In the sample, the attribute is to appear in row 1. 

The third item is the number of the display column in which the attribute char- 
acter is to be placed. In the sample, the attribute character is to be placed in 
column 1. Consequently, the displayed text will begin in column 2. 

Note: Be sure that the display text you want to modify has a blank space imme- 
diately to the left of it. Otherwise, the character representing the attribute in the 
color buffer will overwrite some of the display text, and some characters will 
appear as blanks instead. For example, you cannot make the colon a different 
color from the text in this string: 
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EVENT DESCRIPTION: PROBABLE CAUSE 

• The fourth item is the maximum character length of the attribute. In the sample, 
the specified attribute covers 79 characters on the display, or columns 2 through 
80. 

• The last item is the attribute or sequence of several attributes. In the sample, 
the color blue is the specified attribute. You can specify up to four attributes, 
but only one from each category. If you want multiple attributes to apply to the 
same character or string, you must specify the attributes in the order shown 
below for each category: 

1. Alarm: 

— ALM produces an audible alarm 

2. Intensity: 

— HIG intensifies the color 

— NOH returns the color to normal intensity 

3. Highlighting: 

i 

— REV shows the character or string in reverse video 

— UND underlines the character or string 

— BLI causes the character or string to blink 

4. Color: 

— RED produces red 

— YEL produces yellow 

— BLU produces blue 

— WHI produces white 

— GRE produces green 

— TUR produces turquoise 

— PIN produces pink. 

To summarize, this map element makes the text in row 1, columns 2 through 80, 
blue. As the map element's corresponding comment confirms, this blue string of 
text is the display header. 

Q This type of map element uses the repetition factor option to copy the 
attribute(s) specified for a particular row onto subsequent rows. A repetition map 
element uses the following format: 

• The number 99 signals the repetition of an element. 

• InSlZE-x-y, 

- SIZE represents the total number of rows in the display. Use the word SIZE 
as shown; do not replace it with a number. 

- x is the number of unused or blank lines between the end of display data 
and the prompt line. In the sample, no blank or unused lines occur between 
the end of display data and the prompt line. 

- y is the number of the starting row that is to copy, or repeat, the attribute(s) 
from the row above it. In the sample, attributes from row 6 are to be 
repeated on the subsequent rows, starting with row 7. 

• The last item is the number of attributes on row 6 to be repeated. In the sample, 
the two attributes specified in the map for row 6 are to be repeated. 
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To summarize, this map element copies the two attributes specified for row 6 onto 
subsequent rows, starting at row 7 and continuing to the prompt line. 

Q This last type of map element uses the variable row placement option to specify 
the row that is to contain the attribute. This option uses the following format: 

• The first item is the number of attributes in the map element. This number can 
be from 1 to 4. In the sample, the map element has one attribute, blue color 
(BLU). 

• The second item, SlZE-x, indicates the display row that is to reflect the attribute, 
where: 

- SIZE represents the total number of rows in the display. Use the word SIZE 
as shown; do not replace it with a number. 

- x is the number of lines above the command line. 
For example, for the Alerts-Static display: 

- SlZE-4 is the first prompt line 

- SIZE-3 is the second prompt line 

- SIZE-2 is the message line 

- SIZE-1 is the NetView status line 

- SIZE-O is the command line. 

Note: So that no bytes are overwritten, be sure that the command line is 
defined on byte 80 of the NetView status line. 

In the sample, the attribute is to appear on the first prompt line. 

• The third item is the number of the display column in which the attribute char- 
acter is to be placed. In the sample, the attribute character is placed in 
column 1. Consequently, the displayed text begins in column 2. 

Note: Be sure that the display text you want to modify has a blank space imme- 
diately in front of it. Otherwise, the character representing the attribute in the 
color buffer will overwrite some of the display text, and some characters will 
appear as blanks instead. 

• The fourth item is the maximum character length of the attribute. In the sample, 
the specified attribute covers 50 characters on the display. 

• The last item is the attribute or sequence of several attributes. You may specify 
up to four attributes, but only one from each category. If you want multiple attri- 
butes to apply to the same character or string, you must specify the attributes in 
the order shown on page 58. In the sample, color blue is the specified attribute. 

To summarize, this map element makes the text in the first prompt line, columns 2 
to 51, blue. 

Prompt Highlight Tokens 

The prompt highlight token table, BNJPROMP, is located in the PDS named 
SYS1.BNJPNL2 for MVS and in BNJPROMP filetype NCCFLST for VM, with the color 
maps. It can also be modified. The maximum size of the table is 25 prompts, with 
the prompt being a 15-byte character field. If you decide to modify the table, use the 
comment column for comments about the table. Color is a 3-byte "Character field 
beginning at column 20. You can select only those colors that are valid in the color 
maps. The table has the following format: 
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Table 8. Prompt Highlight Tokens 



Prompt Token 


Color 


Comment 


SEL# 


WHI 


PROMPT SEL# 


LDM 


WHI 


PROMPT LDM 


LSL1 


WHI 


PROMPT LSL1 


LSL2 


WHI 


PROMPT LSL2 


RESNAME 


WHI 


PROMPT RESNAME 


RESNAME1 


WHI 


PROMPT RESNAME1 


RESNAME2 


WHI 


PROMPT RESNAME2 


'A' 


WHI 


PROMPT A 


'B' 


WHI 


PROMPT B 


'P' 


WHI 


PROMPT P 


'EV 


WHI 


PROMPT EV 


'ST' 


WHI 


PROMPT ST 


'DM' 


WHI 


PROMPT DM 


'M' 


WHI 


PROMPT M 


'DEL' 


WHI 


PROMPT DEL 


'S' 


WHI 


PROMPT S 


'D' 


WHI 


PROMPT D 



WHI 



PROMPT R 



The table is read into storage at initialization. You can redefine the prompt highlight 
tokens or add new ones up to a maximum of 25. You will receive a message if the 
table was not successfully read at initialization. 



Using NMVT Support for User-Written Programming 

Network Management Vector Transport (NMVT) support enables user-written pro- 
gramming to report errors to the hardware monitor through generic alerts. In the 
past, Recommended Action panels, Event Detail panels, and alert messages were 
stored at the host in the NetView program. Each pregeneric alert had a unique set 
of panels and messages. With generic alerts, coded information is contained in the 
NMVT, and this information (generic alert code points) is used to dynamically build 
the hardware monitor panels. Pregeneric alerts are mainly used for migration pur- 
poses. New user-defined alerts should be created using generic alerts. For more 
information related to major vectors and subvectors of an NMVT, refer to Systems 
Network Architecture Product Formats. 

This section contains a sample generic alert (Figure 21 on page 63) and the associ- 
ated panels (Figure 22 on page 64, Figure 23 on page 65, Figure 24 on page 66, 
and Figure 25 on page 67) that are built by the hardware monitor. How each panel 
is built is also described. 

Hardware monitor support for user-defined pregeneric alerts is included for 
migration purposes only. Any new alerts should be created in the generic alert 
format. 
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User-Defined Alerts— Pregeneric 

Sixteen block IDs (X'FOO' - X'FOF'), which are part of NMVT Major Vector 0000, are 
reserved for generating user-defined alerts. 

The hardware monitor reserves USERObb - USERFbb for use as the corresponding 
7-character software identifier in the Software Product Program Number (X'08 1 ) 
subfield of the first Product Identifier (X ' 1 1 ' ) subvector of the NMVT. 

The hardware monitor allows a 1-byte alert description code (X'xx 1 ) within the 
Basic Alert (X'91 ') subvector of the NMVT. This code lets you further qualify the 
alert. Put your alert description code in the second byte of the 2-byte Alert 
Description Code field; the hardware monitor ignores the first byte of that field. 

NMVT-to-Panel ID Mapping: Using the block ID derived from the Software Product 
Program Number and the alert description code, the hardware monitor maps the 
NMVT to the following: 

A 14-line panel, which appears on the hardware monitor's Recommended Action 
panel for the NMVT. The 14-line panel's PDS member name is in the range 
between BNlFOOxx and BNlFOFxx, where F00 to FOF is the allowable range of block 
IDs, and xx is the hexadecimal value of the alert description code. The lines can 
be up to 80 characters long. 

A 7-line panel, which appears on the hardware monitor's Event Detail panel for 
the NMVT. The 7-line panel's PDS member name is in the range between 
BNKFOOxx and BNKFOFxx, where F00 to FOF is the allowable range of block IDs, 
and xx is the hexadecimal value of the alert description code. 

The first eight translated characters of each of the first three X'AO' or X' A1 ' 
qualifier subvectors are displayed on an eighth line just below the Event Detail 
panel. Write the event detail messages with titles on the seventh line as needed 
to describe the qualifiers. 

A 48-byte alert description, which appears on the Alerts-Dynamic, Alerts-Static, 
Alerts-History, Event Detail, and Most Recent Events panels. The 48-byte text 
descriptions for a block ID are in a NetView message CSECT whose link-edit 
load module name is in the range between BNJVMF00 and BNJVMF0F. 

Panel Formats: For each new Recommended Action panel or Event Detail panel, 
use the same formats as in the existing panels when adding a panel to the NetView 
panel library or to a concatenated user library. 

For each new 48-byte alert description CSECT, use the same format as an existing 
BNJVMxxx CSECT. The BNJVMxxx CSECT's are coded using the macro DSIMDS. No 
variable substitution is permitted for the 48-byte alert descriptions. 

User-Defined Alerts— Generic 

Generic alerts allow coded alert data to be transported within the alert, thus elimi- 
nating the need for stored panels. The coded data can be either: 

• An index into predefined tables containing short units of text to be used in 
building a display, or 

• Textual data to be displayed directly on the display. 

In both cases, the data is completely independent of the NetView program. The text 
strings indexed by the code points and the display of textual data that was sent in 
the alert are in exactly the same format regardless of what product sent the alert. 
Also, the same terminology will be used to define similar probjems within different 

Chapter 4. Customizing Hardware Monitor Displayed Data 61 



products, since each product will typically use terminology which has been defined 
by IBM. 

Generic alerts produce basically the same Alerts, Recommended Action, and Detail 
panels as the hardware monitor's previous alert support, but the panels are built 
dynamically rather than using stored panels. Code points index into the tables 
defined by IBM and the user. 

The alert description and probable cause code points are used to build the hard- 
ware monitor Alerts-Dynamic, Alerts-Static, Alerts-History, Event Detail, and Most 
Recent Events panels. The user cause, install cause, failure cause, and recom- 
mended action code points are used to build the hardware monitor Recommended 
Action panel. The detail data code points are used to identify the qualifiers which 
may appear on either the hardware monitor Recommended Action or Event Detail 
panel. Products typically use the same set of architected product-independent ter- 
minology to define their Alert, Recommended Action, and Detail panels. Text data 
transported in the NMVT is displayed on the Event Detail panel. 

The NetView program supports two sets of generic alert tables. One is a set of user 
tables into which you can add code points (see "Creating User-Defined Generic 
Code Points" on page 68). The other is a set of tables that contain IBM-supplied 
code points (see NetView Problem Determination and Diagnosis for a list). 

The seven IBM-supplied generic alert tables are: 

BNJ92TBL— alert description code points 
BNJ93TBL— probable cause code points 
BNJ94TBL— user cause code points 
BNJ95TBL— install cause code points 
BNJ96TBL— failure cause code points 
BNJ81TBL— recommended action code points 
BNJ82TBL— detail data code points. 

Using the GENALERT Command: You can use the GENALERT command to create 
your own alerts. The GENALERT command is described in NetView Operation. 
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Building Generic Alert Panels 

Figure 21 is an example of a generic alert NMVT and the unique panels that are built 
using the information contained in the alert. Included after the example is a brief 
explanation of how each panel is built. For more information on NMVTs, see 
Systems Network Architecture Network Product Formats. 



X'41038D5002000000' 

X' 01230000' 

X'0A0108105901020A2827' 

X'0B92000001' 

X'1603' 

X'1A2B3C4D' 

X'0693' 

X'0403' 

X'2012' 

X'1195' 

X'0601' 

X'1502' 

X' 13E1' 

X' 038391' 

X'0681' 

X'0101' 

X'1504' 

X'2796' 

X'0601' 

X'0503' 

X'33C2' 

X' 068200' 

X'61' 

X'0004' 

X'0C82O0' 

X'53' 

X'11FOFO406O4OF1C6' 

X'0A81' 

X'0611' 

X'0500' 

X'3110' 

X'OOEl' 

X' 038321' 

X'1705' 

X' 151000' 

X'07D7E4F9F9F9F900F1' 

X'07D3C9D5C5F0F440F9' 

X'4D1000' 

X' 341 104' 

X'0EO2C1C3C661C9C2D44O4OF0F0F3' 

X'O8O4FOF1FOF2F0F3' 

X'0A06C1C3C661C9C2D440' 

X'0A07C6C6C7C1C9E3D9F3" 

X' 07098603351225' 

X'161101' 

X' 130012' 

X'F9F9F9F9F1F1C1F0F5' 

X' FOCI FOCI FOCI F0' 

X'1798' 

X' 0782213400' 

X'0004' 

X' 0782000911' 

X'F2F2' 

X'0782000E00' 

X'OODC 

X'2548' 

X'1060' 

X'D7C3C9C4D3E4F0F4' 

X'05C3D5D4F0F1' 

X'0D82' 

X ' 00DA1 1C3D6D4D460C5D909 ' 

X'06820GD1010F' 

X'3631" 

X'060211340500' 

X'0512C5D5E4' 

X'032112' 

X'2630' 



Response Header 

Major Vector Length and Key 

01 SV - Date/Time 

92 SV - Alert Description 
code point 

93 SV - Probable Cause (s) 
code point 

code point 

95 SV - Install Cause(s) and Action(s) 
01 SF - install cause(s) 

code point 
code point 
83 SF - qualifier(s) 

81 SF - recommended action(s) 
code point 

code point 

96 SV - Failure Cause(s) and Action(s) 
01 SF - failure cause(s) 

code point 
code point 

82 SF - qualifier(s) 
code point 

82 SF - qualifier(s) 
code point 

81 SF - recommended action(s) 
code point 
code point 
code point 
code point 

83 SF 

05 SV - Resource Hierarchy 

10 SF 
name/type pair 
name/type pair 

10 SV - PSID 

11 SV - Product Identifier 

02 SF - software product serviceable component ID 

04 SF - software product common level 

06 SF - software product common name 

07 SF - software product customization ID 

09 SF - software product customization date and time 
11 SV - Product Identifier 
00 SF - hardware product identifier 



98 SV - Detailed Data 
82 SF - qualifier 

82 SF - qualifier 

82 SF - qualifier 

48 SV - Correlation 
60 SF - correlation for supporting data 

82 SF - qualifier 

82 SF - qualifier 
31 SV - Self Defining Text Message 
02 SF - Coded Character Set ID 
12 SF - National Language ID 

30 SF - Text Message 



X ' E3C8C9E240E2E4C2C6C9C5D3C440C9C4C5D5E3C9C6C9C5E240E3C8C540E3C5E7E34OD4E2 ' 

Figure 21. Sample Generic Alert Record 
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N E T V I E W SESSION DOMAIN: CNMOJ; OPERI 01/02/89 14:41:03 
NPDA-30A * ALERTS-DYNAMIC * 



DOMAIN RESNAME TYPE TIME ALERT DESCRIPTIONrPROBABLE CAUSE 
CNM81 PU9999 *LINE 14:41 COMM SUBSYSTEM FAILURE:COMM SUBSYSTEM CTRL 

Q B B D 



DEPRESS ENTER KEY TO VIEW ALERTS-STATIC 

??? 

CMD— »_ 

Figure 22. Sample of Alerts-Dynamic Display 

An entry on the Alerts panels is built from a number of subvectors (X'92\ X'93', 
andX'05'). 

B The RESNAME (PU9999) and TYPE (LINE) come from the last name/type pair in the 
X'05' subvector. 

B The * indicates that the RESNAME which precedes the type does not belong to the 
type. The type is always associated with the last name in the hierarchy, but the 
name depends on the manner in which the X'05' was coded. The Do Not Display 
Resource Name Indicator bit is set to 1 for the last name/type pair (subvector X'05', 
subfield X'10\ second name/type pair, eighth byte, second bit). (See Figure 21 on 
page 63.) With the bit off, the previous resource name is displayed. 

B The ALERT DESCRIPTION (COMM SUBSYSTEM FAILURE) is derived from code point 
X' 1603' in the X'92' subvector. The code point is used as an index into a table con- 
taining the alert description text messages. 

B The PROBABLE CAUSE (COMM SUBSYSTEM CTRL) is derived from code point X'0403' 
in the X'93 1 subvector. The code point is used as an index into a table containing 
the probable cause text messages. 

B The + is displayed because in this example the X'93 1 subvector contains more 
than one probable cause code point. The + indicates that more probable causes 
can be seen on the Event Detail panel. 
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I N £ T V I £ W SESSION DOMAIN: CNMOl OPER1 01/02/89 14:41:17 
l. NPDA-45A * RECOMMENDED ACTION FOR SELECTED EVENT * PAGE 1 OF 1 
f: CNMOl PU9999 LINE04 Q 

f DOMAIN | PU |- — LINE-— Q 

L . ' ■ ■♦ — ■ + ..• 

I USER CAUSED - NONE Q 

I INSTALL CAUSED - INCORRECT MICROCODE FIX Q 

?. INCORRECT SOFTWARE GENERATION: ACF/IBM Q 

ACTIONS - 1013 - VERIFY X.25 SUBSCRIPTION NUMBER Q 

I 1085 - APPLY CORRECT SOFTWARE LEVEL 

FAILURE CAUSED - COMMUNICATIONS SUBSYSTEM Q 
LINE ADAPTER MICROCODE 

ADAPTER NUMBER 04 
LINE ADDRESS RANGE 00 - IF Q 
ACTIONS - 1032 - DUMP CHANNEL ADAPTER MICROCODE |Q 
1026 - RUN APPROPRIATE TRACE 
1136 - CONTACT COMMUNICATIONS SYSTEMS PROGRAMMER 
1010 - PERFORM 9999 PROBLEM DETERMINATION PROCEDURES 

ig 

ENTER DM (DETAIL MENU) OR D (EVENT DETAIL) 

??? 

CMO«> _ 

Figure 23. Sample of Recommended Action for Selected Event 

The Recommended Action panel is built from a number of subvectors (X ' 94 ' , X ' 95 ' , 
and X'96') and subfields (X'01 ', X'81 \ X'82', and X'83'). 

Q The resource names (PU9999 and LINE04) are taken directly from the X'05' hier- 
archy names list subvector. In this example, only names from the X'05' subvector 
were used because the Hierarchy Complete Indicator bit (byte 2 bit 0) in the X'05 1 
subvector was set to 0. If this bit were set to 1, the NetView program would concat- 
enate the names in the X'05 1 subvector to the names supplied by VTAM. 

The resource types (PU and LINE) are derived by converting the type codes in 
the X' 10' subfieldoftheX'05' subvector (X ' F1 ' and X'F9') into displayable 
resource types. For more information on changing resource types, see "Adding or 
Modifying Resource Types" on page 71. 

Qj The X'94' subvector carries user-caused information. Because no X'94' sub- 
vector is in the sample NMVT, no user-caused information is displayed. 

Q The two install -caused probable causes are built from code points (X'1502' and 
X'13E1 ') in the X'01 ' subfield within the X'95' subvector. Note that the E in the 
X'13E1 ' code point indicates an X'83' subfield is needed to complete the install 
cause. 

H The qualifier on the install cause (ACF/IBM) is displayed because of the X'83 1 
subfield of the X'95 1 subvector. The X'83 1 subfield contains the value X'91 ' which 
indicates that the qualifier should be taken from the product ID subfield (X'06 1 Soft- 
ware Product Common Name) of the first product identifier subvector (X'11 '). 

The two install-caused actions are taken from code points (X'0101 ' and 
X'1504') in the X'81 ' subfield of the X'95' subvector. 
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Q The two failure-caused probable causes are taken from code points (X'0503* 
and X'33C2') in the X'01 ' subfield of the X'96' subvector. Note that the C in the 
X'33C2' code point indicates that two X'82' subfieids are needed to complete the 
failure cause. 

ADAPTER NUMBER 04 is broken down from the first X'82 1 subfield in the X'96 1 
subvector as follows: 

00 indicates no information will be taken from the PSID subvector 

61 a code point for adapter number 

00 indicates that hexadecimal data follows 

04 hexadecimal data to be displayed. 

Q LINE ADDRESS RANGE 00 - IF is broken down from the second X'82 1 subfield in 
the X'96' subvector as follows: 

00 indicates no information will be taken from the PSID subvector 

53 a code point for line address range 

11 indicates that EBCDIC data follows 

FOF0406D40F1C6 EBCDIC data to be displayed. 



Q The failure-caused actions are taken from the code points (X'0611 \ X'0500', 
X'SHO'.andX'OOEI'JintheX'Sr subfield of the X'96' subvector. Note that the E 
in the X'00E1 ' code point indicates that an X'83' subfield is needed to complete the 
failure cause. 

EQj The qualifier on the failure cause (9999) is displayed because of the X'83* sub- 
field of the X'96' subvector. The X'83' subfield contains the value X'21 ' which 
indicates that the qualifier should be taken from the first hardware PSID subfield 
(X ' 00 • ) of the PSID subvector (X ' 1 1 ' ). 



N E T V I 


E W 


SESSION DOMAIN: CNM01 0PER1 


01/02/89 14:41:32 


NPDA-43S 




* EVENT DETAIL * 


PAGE 1 OF 2 


CNM81 


PU9999 


LINE04 Q 




DOMAIN 


| PU 


|- — LINE- — Q 





+ + 

DATE/TIME: RECORDED - 01/02 10:41 CREATED - 01/02/89 10:40:39 Q 

EVENT TYPE: PERMANENT Q 

DESCRIPTION: COMMUNICATIONS SUBSYSTEM FAILURE Q 
PROBABLE CAUSES: 

COMMUNICATIONS SUBSYSTEM CONTROLLER Q 

TOKEN-RING LAN 

QUALIFIERS: 

1) 9999 COMMUNICATION CONTROL UNIT 0004 Q 

ENTER A (ACTION) OR DM (DETAIL MENU) 

??? 

CMD«> _ ■ 

Figure 24. Sample of Event Detail Display (page 1) 
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• NETVI EW SESSION DOMAIN: CNM01 OPER1 01/02/89 14:41:49 

I HPDA-43S * EVENT DETAIL * PAGE 2 OF 2 

I CNM01 PU9999 UNE04 

+ + 

| DOMAIN 1 PU | LINE- — 

f +~ * 

v- QUALIFIERS (CONTINUED): 
I 2) EVENT CODE 22 
?-'■ 3) REASON CODE OODC 

CONTROL PROGRAM TEXT: Q 
f THIS SUBFIELD IDENTIFIES THE TEXT MS 

r CORRELATION FOR SUPPORTING DATA Q 

PCID: PCI0LU01 NETWORK QUALIFIED NAME: CNM01 
*» 1) LOG ID COMM ERR 
£ 2) LOG RECORD NUMBER 15 

I '••'■■ 

i UNIQUE ALERT IDENTIFIER: PRODUCT ID - ACF/IBM ALERT ID NUMBER - 1A2B3C4D 

I IS ID 

I ENTER A (ACTION) OR DM (DETAI1 MENU) 

|? -??? ' ■"" 

JCMD«>_ 

Figure 25. Sample of Event Detail Display (page 2) 

The Event Detail panel is built from subvectorsX'92', X'93\ X'98\ X'01\ X'31\ 
and X'48' and subfield X'82'. 

Q The resource names (PU9999 and LINE04) are taken directly from the X'05' hier- 
archy names list subvector. In this example, only names from the X'05 1 subvector 
are used because the Hierarchy Complete Indicator bit (byte 2 bit 0) in the X'05 1 
subvector was set to (see Figure 21 on page 63). If this bit were set to 1, the 
NetView program would concatenate the names in the X'05' subvector to the names 
supplied by VTAM. 

Q The resource types (PU and LINE) are derived by converting the type codes in the 
X'10' subfield of the X'05' subvector (X'FV andX'F9') into displayable resource 
types. For more information on changing resource types, refer to "Adding or Modi- 
fying Resource Types" on page 71. 

B The DATE/TIME RECORDED is the time the record was logged to the hardware 
monitor data base. The field shows the time the record was created by the sending 
product. It is taken from the X' 10' subfield of the X'01 ' subvector. 

Q EVENT TYPE is derived from byte 4 (Alert Type) of the X'92' subvector. 

B DESCRIPTION is derived from the code point (X'1603 1 ) in the X'92 1 subvector as 
is the description on the Alerts panel. However, a longer version of the text is dis- 
played on this screen. 

B PROBABLE CAUSES are taken from the code points (X'0403 1 and X'2012') in the 
X'93' subvector. Just as with the description, a longer version of the text is dis- 
played than was displayed on the Alerts panel. Also, all of the probable causes are 
displayed. 

B QUALIFIERS are derived from the X'82 1 subfields of the X'98' subvector. Note 
that the NetView program ignores X'01 ' subfields and associated sub-subfields 
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(including X'82') in a X'98' subvector. The qualifiers can be broken down as 
follows: 

First X'82' subfield: 

21 indicates the data should be taken from the first hardware PSID 

subfield (X'OO') of the PSID subvector (X'11 '). 
34 code point indicating communication control unit 

00 indicates that hexadecimal data follows 

0004 hexadecimal data to be displayed. 

Second X'82' subfield 

00 indicates no data will be taken from the PSID subvector 

09 code point indicating event code 
11 indicates that EBCDIC data follows 
F2F2 EBCDIC data to be displayed. 

Third X'82' subfield 

00 indicates no data will be taken from the PSID subvector 

OE code point indicating reason code 

00 indicates that hexadecimal data follows 

OODC hexadecimal data to be displayed. 

Page 2 of the Event Detail panel contains the following information: 

The control program text title is displayed because of subfield X'21 ' of sub- 
vector X'31 '. The text itself is taken directly from subfield X'30' of the X' 31 ' sub- 
vector and displayed on the screen. 

Q The correlation for supporting data section is displayed from the X'48' sub- 
vector. Subfield X'60' specifies the network qualified procedure correlation identi- 
fier be used to uniquely identify a session. Two X'82 1 subfields identify the 
supporting data. 

10 The product ID (ACF/IBM) is taken directly from the first product identifier (X* 11 ') 
subvector in the first PSID (X 1 10') subvector. In this example, the Software Product 
Serviceable Component Identifier (X'02 1 ) subfield is used. 

The alert ID number (1A2B3C4D) is taken from subvector X' 92' bytes 7-10. 

Creating User-Defined Generic Code Points 

This section explains how to obtain problem determination support for devices and 
applications in your network using code points that the NetView program does not 
automatically support. You enter data into seven user tables that are shipped with 
the NetView program. The user tables code point range, X'EOOO' to X'EFFF', is 
reserved for your use; however, any code points not used in IBM-supplied tables can 
also be used. To create a help panel for a user-defined code point or an 
IBM-defined code point, follow the instructions under "Creating New Panels" on 
page 39. 
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Defining User Tables 

For MVS, submit the NetView sample CNMSJM08 (found in the Network Program Pro- 
ducts Samples), which allocates the PDS, CNM.CODE.POINTS, and is defined by 
USERLIB in CNMSJM07. CNMSJM08 contains seven members referred to as tables 
(see below). 

For VM, running the NetView sample, CNMSVM08 (found in Network Program Pro- 
ducts Samples), creates seven CMS files referred to as tables (see below). The 
filetype is NCCFLST. CNMSVM08 accepts the filemode as an input parameter. For 
example, coding CNMSVM08 NCCFLST K creates the seven tables on the minidisk 
accessed as K. The filemode default is A. 



Table Formats 



The seven user tables are: 

• BNJ92UTB— alert description code points 

• BNJ93UTB— probable cause code points 

• BNJ94UTB— user cause code points 

• BNJ95UTB— install cause code points 

• BNJ96UTB— failure cause code points 

• BNJ81UTB— recommended action code points 

• BNJ82UTB— detail data code points. 

Each table contains a different type of code point. The fourth and fifth characters of 
the table name identify the subvector or subfield that contains the code points. 

An example of the data in the tables is shown in Figure 26. The numerical refer- 
ences are explained following the figure. 

g ■" '"■ "™~ 

EQE2 x PROGRAM CHECK IN PROGRAM; Q 

* this is a sample comment 

0G320 x PERSISTENT DCE CLEAR INDICATION DURING CALL ESTABLISHMENT (T6 TIMER EXPIRED) 

E9E1 Y MODEM $ POWERED OFF; 

FFFF0 

Figure 26. Sample User-Defined Table 

Q The code point is a 4-character hexadecimal number, starting in column 1. 
Valid characters are through 9 and A through F. The code point range X'EOOO' to 
X'EFFF 1 has been reserved for your use. Unused code points outside this range can 
also be used, although they could be used by IBM in the future. The last entry in the 
table must be code point FFFF. Any entries after FFFF are not processed. One blank 
must follow the code point. 

Note: Code points in table BNJ82UTB must be left-justified and padded with O's. For 
example, you would enter code point 12 as 1200. 

If the code point is not found in the IBM table, the equivalent user-defined table will 
be searched for the same code point. If a code point is received that is within the 
X'EOOO 1 to X'EFFF' range, only the user-defined table will be searched. 
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Q The text description appears in columns 8 through 72 on the hardware monitor 
displays. The maximum length varies as follows: 

Probable cause 20 characters 

Alert description 25 characters 

Detail data 40 characters 

Others 108 characters. 

To continue the text on the next line, start in column 2. 

If you want to imbed data from the X'82' or X'83' subfield in the text, mark the 
imbed position with a dollar sign ($). No variable substitution can be done for prob- 
able cause text (BNJ93UTB) and alert description text (BNJ92UTB). 

El A semicolon, indicating end of text, is required. 

You can insert comment lines anywhere in the table by placing an asterisk in 
column 1. The remainder of that line serves as the comment. 

Q Figure 26 on page 69 shows code point 0320 which is outside the reserved user 
code point range. You may want to use this 0320 in case it becomes an IBM-supplied 
code point after this NetView release. If the NetView program adds support, the 
code point text in the user table would be overridden by the code point text in the 
NetView table. 

EI The imbed flag, shown as a y in column 6, indicates that a qualifier flag is 
turned on when the data associated with X'82' or X'83' subfield is to be placed 
before the code point's text, imbedded within the code point's text, or is following on 
the same line immediately after the code point's text. One blank must follow the 
imbed flag. Any character other than y indicates the imbed flag is off. If the imbed 
flag is turned on, the information is imbedded at the point marked by a dollar sign 
($). Since no variable substitution can be done for probable cause and alert 
description, an imbed flag is ignored in BNJ93UTB and BNJ92UTB. 



Link-Editing the User Tables 
For MVS: 



• 



CNMSJM07 parses the user tables for validity and link-edits them into a 
user-defined load data set. This data set should be concatenated in the STEPLIB 
of the NetView start procedure before SYS1.NPDALIB. 

Refer to Network Program Products Samples for an explanation of the parame- 
ters and execution of CNMSJM07. 

If no errors are found, the user table is link-edited into the data set defined to 
NETLNK in CNMSJM07. If errors are found, the job ends with a nonzero return 
code. A list of the errors is written to SYSPRINT. 



For VM: 



CNMSVM07 parses the user tables for validity and link-edits them into a 
user-defined LOADLIB. This LOADLIB should be ahead of the NPDA LOADLIB in 
the GLOBAL LOADLIB statement in the NETSTRT GCS file. 

Refer to Network Program Products Samples for an explanation of the parame- 
ters and execution of CNMSVM07. 
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• If no errors are found, the user table is link-edited into the load library defined in 
CNMSVM07. If errors are found, the exec ends with a nonzero return code. A list 
of the errors is written to SYSPRINT. 

Note: The NetView program recognizes only user-defined code points available at 
initialization. If additional code points are added while the NetView program is 
running, stop and restart the NetView program so the new code points will be recog- 
nized. 

Adding or Modifying Resource Types 

You can add new resource types for hierarchical displays in the hardware monitor 
by modifying the member BNJRESTY. 

• For MVS, BNJRESTY is a member of the data set SYS1.BNJPNL2, defined by the 
definition statement BNJPNL2 in the NetView start procedure. 

• For VM, BNJRESTY is a CMS file with a filetype of NCCFLST. 

Figure 27 shows the format for BNJRESTY. The numerical references are explained 
after the figure. 

10 DISK your comments 
Figure 27. Sample Contents of BNJRESTY 

Q A 2-character hexadecimal number, starting in column 1, flows to the NetView 
program in the X'05' subvector. Valid characters are through 9 and A through F. If 
you include duplicate hexadecimal codes, the system uses the first entry for that 
code in BNJRESTY. 

Q The four characters in columns 4 through 7 are taken as the resource type. 
Valid characters are through 9, A through Z, and any printable special characters. 
A resource type of fewer than four characters must be padded on the right with 
blanks. Delimiters such as a comma (,), period (.), or equal sign (m) should not be 
used as characters in the resource type. 

An optional comment can begin anywhere after the resource type. 

If you modify BNJRESTY while the hardware monitor task BNJDSERV is active, the 
new resource types will not be recognized. You must use STOP TASK followed by 
STARTCNM NPDA to cause the NetView program to recognize any new resource 
types. 

If the NetView program finds an invalid entry in BNJRESTY during activation of 
BNJDSERV, an error message appears on the command facility console and 
IBM-supplied resource types are used instead. 
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Chapter 5. Modifying SPCS and NAM Command Lists 

This chapter describes service point command service (SPCS) commands and how 
to modify SPCS command lists. It also describes network asset management (NAM) 
command lists. 



Service Point Command Service 

The SPCS is a set of commands that support and enhance the NetView program's 
control of service points such as the NetView/PC interface program. A service point 
application manages non-SNA devices, such as front-end line switches and 
multiplexers. You can send commands to the service point application to do 
problem determination for these devices. 

Four NetView SPCS commands can be used with service points for problem determi- 
nation (see NetView Operation for the command format): 

• LINKTEST— requests that the service point test a given link or link segment. 

• LINKDATA— requests that the service point return device data for a given link or 
link segment. 

• LlNKPD— requests problem determination analysis from the service point on a 
given link or link segment. 

• RUNCMD— sends service point application commands to the service point appli- 
cations from the NetView program. 

The SPCS commands are long-running commands that suspend the command list 
when they are executed. The command list resumes when the SPCS command is 
completed. After the command is completed, a return code is set. See NetView 
Customization: Writing Command Lists for more information. 



Using SPCS Commands 



The NetView program provides six command lists which issue SPCS commands; 
they may give you ideas on how to use SPCS commands from command lists for 
automation. You can modify these command lists for your particular application or 
use them as ideas for your own command lists. Following are the names and 
descriptions of each of the six command lists. 

INITCNFG Contains the service point resource information. This command list 
will not work if any lowercase values are used. The configuration 
defined in INITCNFG should match the configuration of the lines con- 
trolled by your service points. If you invoke the INITCNFG command 
list from your NCCFIC command list, these global variables will be set 
up every time the NetView program is started. You can modify the fol- 
lowing fields to contain the configuration of all the lines that you will 
be controlling with the SPCS commands. 
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ADDLINE 



SPLOOKUP 



FINDNCP 



TESTSP 



TESTRCMD 



LINE line name 

SP service point name 

APPL application name 

UN using node name 

RD remote device name 

Enter BROWSE INITCNFG to see this command list online. 

Allows you to define common global variables for a new line to the 
SPLOOKUP command list. The syntax is: 

ADDLINE LINE, SP, APPL, UN, RD 



(UN and RD are not required. LINE, SP, and APPL are required.) 
BROWSE ADDLINE to see this command list online. 



Enter 



Allows you to issue SPCS commands for a given line. SPLOOKUP 
determines the parameters needed to issue an SPCS command for the 
line from the global variables set up by INITCNFG. If SPLOOKUP is 
invoked with the LINE option, it returns the SP name, the APPL name, 
using node, and remote device for the specified line in task global var- 
iables SP, APPL, UN, and RD. If invoked with the SP option, SPLOOKUP 
returns a list of lines defined to the specified SP name in the task 
global variables LINECNT, LINE1, LINE2, and so forth. The syntax is: 

SPLOOKUP LINE linename 

SPLOOKUP SP spname 

Enter BROWSE SPLOOKUP to see this command list online. 

Displays events received by the NetView program from the using node 
for a service point. This command list is useful if you are having prob- 
lems getting data back from a service point, findncp looks up the 
using nodes for a given SP. If multiple using nodes are defined, they 
are listed. If only one using node is defined, FINDNCP invokes the 
NPDA Most Recent Events panel to show any events for the using 
node. Normally, the using node is the NCP linked to the SP. The 
syntax is: 

FINDNCP spname 

Enter BROWSE FINDNCP to see this command list online. 

Is used to issue SPCS commands for a given line. TESTSP invokes 
SPLOOKUP and then issues the SPCS commands and displays the 
results. You can use TESTSP as a base for command lists that execute 
SPCS commands automatically. It also demonstrates how to display 
results of the LINKTEST and LINKDATA commands. The syntax is: 

TESTSP linename 

Enter BROWSE TESTSP to see this command list online. 

Demonstrates how to use RUNCMD with the CLISTVAR keyword. It 
issues RUNCMD to execute a command at the service point. Results 
are stored in command list variables, and displays the data when 
control is returned. 
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The syntax is: 

TESTRCMD sp appl •command to execute at the service point' 

(The command must be in single quotes.) Enter BROWSE TESTRCMD to 
see this command list online. 



NAM Command Lists 



Network asset management (NAM) provides an automated way of collecting inven- 
tory data from a subset of hardware and software devices. You can use NAM to 
collect vital product data (VPD) such as serial numbers, machine types, and model 
numbers for hardware products and software information, such as version and 
release level. However, the NetView program does not verify the returned data 
from devices supporting NAM. It only provides a way to collect and log the data. 
See NetView Administration Reference for information on the record formats. See 
NetView Operation for information on the IBM-supplied command lists. 

Any device that supports the REQUEST/REPLY PSID and LPDA-2 architecture can 
report vital product data to the NetView program. (See Systems Network Architec- 
ture Product Formats.) An attempt to solicit vital product data from a device that 
does not support the architecture may cause the keyboard to lock or extraneous 
data to appear on the screen. You may need to press the reset key or clear the 
screen. This does not affect vital product data collection in the NetView program. 

Following are some examples of physical units (PU) which support the 
REQUEST/REPLY PSID architecture. 

• 3720/NCP, 3725/NCP, 3745/NCP 

• 3174 — Reports data for itself and many types of attached devices such as: 

- Various models of 3191, 3192, and 3194 displays 

- Various models of PS/2, PC/AT, and PC/XT (OS/2-EE required). 

(See the user's guides, including the OS/2 EE user's guide, for each of the 
previous devices for instructions on entering vital product data into the 
device.) 

Following are some examples of data communications equipment (DCE) which 
support the LPDA-2 modem and line status architecture. 

• 586X modems 

• 5822DSU/CSU 

• 7865/7825 

• 7861/7868 

The following software is required to support vital product data collection. 

• VTAM V3R1.1 (with PTF UT25170) and subsequent releases 

• NCP V4R3 and subsequent releases (hardware and software data)— A communi- 
cations controller that is running NCP V4R3 reports both hardware and software 
information. (NCP V4R2 (software data only) — A communications controller that 
is running NCP V4R2 only reports data about the software it is running.) 

• 3174 R4 microcode. 

NAM provides the VPDCMD command to solicit vital product data from a given 
device, and the VPDLOG command to build and log a record to an external logging 
facility (SMF for MVS or the external log for VM). You may want to use Service Level 
Reporter (SLR) to view the data interactively or generate reports. You may use the 
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VPDALL command to generate VPDPU and VPDDCE command entries for all devices 
"' within a NetView domain. (See NetView Operation for information on the vital 
product data commands.) If you have any resources that require switched lines, be 
sure those lines are up before collecting vital product data. 

NAM provides the following command lists: 

VPDPU Collects and logs vital product data from a single PL) and its attached 

devices. You can enter this command list from an operator's console 
or from another command list. See NetView Administration Reference 
for the record formats and NetView Operation for a description of 
VPDPU. 

VPDDCE Solicits and logs vital product data from OCEs that are in a direct path 
between a specified NCP and a specified PU. You can issue this 
command list from an operator's console or from within another 
command list. See NetView Administration Reference for the record 
formats and NetView Operation for a description of VPDDCE. 

VPDACT Is the default name of a command list that the VPDALL command gen- 
erates when issued with the CREATE option, vpdall reads a VTAM 
configuration member in VTAMLST as input and generates a command 
list called VPDACT (the default). VPDACT contains a list of VPDPU and 
VPDDCE entries for devices in your domain. VPDACT can be issued 
later by an operator to collect and to log vital product data from sup- 
ported devices in the NetView domain. 

VPDLOGC Is the command list that builds and logs START and END records. A 

START record is generated for a VPDACT command list at the beginning 
of a vital product data solicitation. An END record is generated for a 
VPDACT command list at the end of a vital product data solicitation. 
See NetView Administration Reference for the record formats. This 
command list should not be issued from an operator's console nor 
from within a user-written command list. 

VPDXDOM Is a service command list used for vital product data solicitation from 
cross-domain resources. This command list is driven through a 
message automation table and should not be issued from an 
operator's console nor from within a user-written command list. 

Vital Product Data Collection from a Single Physical Unit 

The following example describes collecting vital product data from a single PU and 
its attached devices. 

1. Issue VPDPU or VPDDCE command list with a resource name specified. 

2. The command list issues a VPDCMD to solicit data from the specified resource 
and waits for response messages. 

3. A PU responds with vital product data for itself or for itself and its attached 
devices. 

4. The command list traps the response messages and saves the vital product 
data, such as machine type, model number, serial numbers, in command list 
variables. 

5. When the completion message is received, the command list builds records and 
writes them to an external logging facility. 

6. If any abnormal events (such as a SMF logging failure, VPDTASK is inactive, an 
ABEND) occur before completion, a command list error message is issued and 
the command list terminates. 



76 Customization Guide 



Vital Product Data Collection from a Single NetView Domain 

The following example describes collecting vital product data from a single NetView 
domain. 

1. A NetView operator enters the following command: 

VPDALL CONFIG(ATCCONOl) , CREATE, CLIST(VPDACT) , ADD 



VPDALL reads the specified nodes from the configuration member (ATCCON01 in 
this example) in VTAMLST. VPDALL extracts from the VTAMLST nodes all the 
resource names for which vital product data is to be collected. It then builds 
VPDPU and VPDDCE entries in a command list called VPDACT. VPDALL does not 
support DCEs on switched lines nor dynamic reconfiguration decks (DRDS). 

Note: In order to collect data from your entire domain, the configuration 
member must contain the definitions for all the resources in your domain. 
You can modify VPDACT by adding or deleting resource names. 
When the VPDACT command list is executed, it calls VPDLOGC to generate a 
START record. It then calls the VPDPU and VPDDCE command lists. When the 
VPDPU and VPDDCE command lists have completed, VPDACT again calls 
VPDLOGC to generate an END record. 



Focal Point Vital Product Data Collection 

Figure 28 illustrates a focal point NetView for vital product data collection and is 
described in the example following the figure. 



NVl 



SMFVPD=200 



OST 



VPDXDOM Changes 
SMFVPD to 200 
A 

I 
DSIMSG01 



NV2 




External 








Luyy my 


NNT 






SMFVPD=250 





AAA 



START DOMAIN 



ROUTE NV2, START VDPTASK 



ROUTE NV2, VDPACT 



MSG OP ID X$S VDPLOG 250 DATA 
L 

Figure 28. Vital Product Data Focal Point NetView 



The following example describes collecting vital product data at a focal point 
NetView. 

1. During installation, NV1 sets the common global variable SMFVPD to 200. NV2 
sets it to 250. 

Note: The NetView initial command list (CNME1034) sets the common global 
variable SMFVPD to 37. 

2. Also during installation, NV1 is designated as a focal point NetView for vital 
product data collection. In the message automation table (DSIMSG01), for NV1 
only, uncomment the statement to drive the VPDXDOM command list. See 
NetView Installation and Administration Guide for information on DSIMSG01. 

3. Start DSIELTSK from the focal point NetView NV1. 

4. NV1 (the focal point) establishes a direct OST to NNT session with NV2 via the 
START DOMAIN command. 
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5. NV1 (the focal point) issues START VPDTASK. 

6. NV1 (the focal point) issues ROUTE NV2, START VPDTASK. 

7. NV1 (the focal point) issues ROUTE NV2, VPDACT (for example). This causes the 
VPDACT command list in NV2 to run under an NNT. 

8. In NV2, VPDACT verifies that it is running under the NNT and then generates the 
following message: 

MSG OPID X$S VPDLOG 250 '1 STRING1 10 STRING2...' 

(x$s is a special string that is recognized by the message automation table.) 

9. When the VPDACT command list in NV2 writes the generated message to the 
operator in NV1, it triggers the message automation table. The message auto- 
mation table executes the VPDXDOM command list in NV1. 

10. When VPDXDOM is entered, the message string looks like this 

DSI039I MSG FROM OPID : X$S VPDLOG 250 1 STRING1... 

11. VPDXDOM verifies that NV1 has set SMFVPD as a common global variable. Since 
it has, the command list changes SMFVPD from 250 (NV2) to 200 (NV1). 

12. VPDLOG executes and the data is logged under NV1 *s SMF record number 200. 

13. Be sure the cross-domain session remains established until the vital product 
data solicitation is completed for that session. 

Customization Considerations 

You may want to customize the IBM-supplied vital product data command lists to 
suit the needs of your installation. 

When modifying NAM command lists to build different record formats, do not exceed 
256 bytes per record. The NetView program has a command string limitation of 240 
characters. Therefore, you may need to write a command processor to make full 
use of the VPD command. See NetView Customization: Using Assembler for infor- 
mation on command processors. If you are changing the SMF record format, you 
can no longer use the record number 37. You must globally define the SMF record 
number within the user-defined range of 128 to 255. If you are using SLR, the SLR 
table must be written to match your modified SMF record format. 

See NetView Operation and NetView Customization: Writing Command Lists for lim- 
itations concerning the use of &WAIT and RESET, and the issuance of a second NAM 
command list and NAM command while a NAM command list is running. 

To try increasing performance, 

• You can write a command list that reads in VPDACT to distribute the workload 
among several autotasks. Dividing the workload among several OSTs or 
autotasks allows multiple VPDPU or VPDDCE entries to execute simultaneously. 
Otherwise, the VPDPU and VPDDCE entries are executed serially. 

• Create several configuration members. 

— For example, one member per major node. 

— Using VPDALL, create several command lists. 

— Each command list can be run under several tasks, such as an OST and an 
autotask. 
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Appendix A. Color Maps for Hardware Monitor Panels 

The following table lists the display name, display number, and color map for hard- 
ware monitor panels. See Chapter 4, "Customizing Hardware Monitor Displayed 
Data" on page 45 for more information on color maps. 



Table 9 (Page 1 of. 4). Color Maps for Hardware Monitor Displays 



Display Name 



Display Number 



Color Map 



Alerts-Dynamic 
Alerts-Dynamic, rolling 
Alerts-History 
Alerts-Static 



Attached EV/ST Data 



NPDA-30A 
NPDA-30A 
NPDA-31A 
NPDA-30B 



BNJMP30A 
BNJMP30R 
BNJMP31A 
BNJMP30B 



Command Description 


NPDA-31N2 


BNJMP11NB 


Command Description Alerts-Dynamic 


NPDA-11A 


BNJMP11A 


Command Description Controller 


NPDA-11M 


BNJMP11M 


Command Description Copy 


NPDA-11S 


BNJMP11S 


Command Description Display Domain 


NPDA-11K 


BNJMP11K 


Command Description Display Ratio 


NPDA-11Q 


BNJMP11Q 


Command Description Display Wrap Count 


NPDA-11F 


BNJMP11F 


Command Description Filter Status 


NPDA-111 


BNJMP11I 


Command Description Most Recent 


NPDA-11D 


BNJMP11D 


Command Description Most Recent, alternate 


NPDA-11DB 


BNJMP11DB 


Command Description Purge 


NPDA-11N3,page2 


BNJMP1NC 



Command Descr 
Command Descr 
Command Descr 
Command Descr 
Command Descr 



ption Purge EV/ST Data 
ption REPORTS 
ption Set Domain 
ption Set Ratio 
ption Set Wrap Count 



NPDA-11N1,page1 

NPDA-11R 

NPDA-11J 

NPDA-11P 

NPDA-11E 



BNJMP1NA 

BNJMP11R 

BNJMP11J 

BNJMP11P 

BNJMP11E 



Command Descr 
Command Descr 
Command Descr 
Command Descr 
Command Descr 



ption SRFILTER 
ption SRFILTER 
ption SRFILTER 
ption SRFILTER 
ption SRFILTER 



NPDA-11GA 
NPDA-11GB 
NPDA-11GC 
NPDA-11GD 
NPDA-11GE 



BNJMP1GA 
BNJMP1GB 
BNJMP1GC 
BNJMP1GD 
BNJMP1GE 



Command Descr 
Command Descr 
Command Descr 
Command Descr 
Command Descr 



ption SVFILTER 
ption SVFILTER 
ption SVFILTER 
ption TEST 
ption TOTAL 



NPDA-11HA 

NPDA-11HB 

NPDA-11HC 

NPDA-11L 

NPDA-11C 



BNJMP1HA 
BNJMP1HB 
BNJMP1HC 
BNJMP11L 
BNJMP11C 



Command Description TOTAL, alternate 

Command List 

Command List 

Common Format Glossary 



NPDA-11CB 
NPDA-10AA, page 1 
NPDA-10AB, page 2 
NPDA-02C 



BNJMP1CB 
BNJMP10A 
BNJMP10B 
BNJMP2C1 



Controller Information Display 
Controller (CTRL) Selection Menu 
Downstream Member of Token-Ring LAN Fault 
Domain 



NPDA-02E 

NPDA-CTRL 

NPDA-44B 



BNJMP02E 
BNJMPCTL 
BNJMP4BH 



DSU/CSU and Line Status 

DSU/CSU and Line Parameters 
Link Segment Level n 



NPDA-22C, page 1 



BNJMPDL1 



DSU/CSU and Line Status 

Remote DSU/CSU Interface-Remote Device 
Status-Link Segment Level n 



NPDA-22C, page 2 



BNJMPDL2 
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Table 9 (Page 2 of 4). Color Maps for Hardware Monitor Displays 



Display Name 



Display Number 



Color Map 



DSU/CSU and Line Status 
Configuration Summary, Link Segment Level n 



NPDA-22C, page 3 



BNJMPDL3 



Event Detail 
Event Detail 
Event Detail 
Event Detail 
Event Detail 



NPDA-43B 
NPDA-43M 
NPDA-43N, 43Q 
NPDA-43C 
NPDA-43T 



BNJMP438 
BNJMP43M 
BNJMP43N 
BNJMP43C 
BNJMP43T 



Event Detail 

Event Detail 

Event Detail 

Event Detail, alternate 

Event Detail, alternate 



NPDA-43A 
NPDA-43P 
NPDA-43S 
NPDA-43T 
NPDA-43S 



BNJMP43A 
BNJMP43P 
BNJMP43S 
BNJMP434 
BNJMP433 



Event Detail for BSC Line 


NPDA-43T 


BNJMP43T 


Event Detail for BSC Station 


NPDA-43T 


BNJMP43T 


Event Detail for BSC/SS Line 


NPDA-43B 


BNJMP43B 


Event Detail for BSC/SS Station 


NPDA-43B 


BNJMP43B 


Event Detail for Channel-Attached Station 


NPDA-43B 


BNJMP43B 


Event Detail for Channel Link 


NPDA-43B 


BNJMP43B 


Event Detail for Instruction Exception 


NPDA-43J 


BNJMP43J 


Event Detail for Miscellaneous Interrupts 


NPDA-43K 


BNJMP43D 


Event Detail for Scanner-Type 1/4 


NPDA-43G 


BNJMP43D 


Event Detail for Scanner-Type 2/3 


NPDA-43H 


BNJMP43D 


Event Detail for Scanner-Type 1 


NPDA-43D 


BNJMP43D 


Event Detail for Scanner-Type 2 


NPDA-43E 


BNJMP43D 


Event Detail for Scanner-Type 3 


NPDA-43F 


BNJMP43D 


Event Detail for Scanner-Type 4 


NPDA-43I 


BNJMP43D 


Event Detail for SDLC Line 


NPDA-43P 


BNJMP43B 


Event Detail for SDLC Line 


NPDA-43T 


BNJMP43T 


Event Detail for SDLC Station 


NPDA-43B 


BNJMP43B 


Event Detail for SDLC Station 


NPDA-43T 


BNJMP43T 


Event Detail for 3270 Non-SNA Controller 


NPDA-43L 


BNJMP43L 



Event Detail Menu 
Event Detail Menu 



NPDA-43R 
NPDA-43R 



BNJMP43R 
BNJMP43R 



Event Detail Menu, alternate 

Event Detail Menu for BSC Line 

Event Detail Menu for BSC Line, alternate 

Event Detail Menu for BSC Station 

Event Detail Menu for BSC Station, alternate 



NPDA-43R 
NPDA-43R 
NPDA-43T 
NPDA-43R 
NPDA-43T 



BNJMP432 
BNJMP43R 
BNJMP434 
BNJMP43R 
BNJMP434 



Event Detail Menu for SDLC Line 

Event Detail Menu for SDLC Line, alternate 

Event Detail Menu for SDLC Station 

Event Detail Menu for SDLC Station, alternate 

Event Summary 



NPDA-43R 
NPDA-43T 
NPDA-43R 
NPDA-43T 
NPDA-42A 



BNJMP43R 
BNJMP434 
BNJMP43R 
BNJMP434 
BNJMP42A 



Event Summary 

Event Summary 

Glossary displays 

Hexadecimal Display of Error Record 

HELP Menu 



NPDA-42B 
NPDA-42C 
(many displays) 
NPDA-44C 
NPDA-02B 



BNJMP42B 

BNJMP42C 

BNJMPGLO 

BNJMP44C 

BNJMP02B 



Line Analysis-Link Segment Level n 

Link Configuration 

Link Configuration 

Link Configuration, alternate 



NPDA-24B 
NPDA-44A1 
NPDA-44A2 
NPDA-44A1 



BNJMPLNA 
BNJMP441 
BNJMP442 
BNJMP443 
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Table 9 (Page 3 of 4). Color Maps for Hardware Monitor Displays 



Display Name 



Display Number 



Color Map 



Link Configuration Summary-Level Selection 
Link Data for SNA Controller 
Link Problem Determination Aid (LPDA-l)Data 
Link Problem Determination Aid (LPDA-1) 
LDM Data 



NPDA-LSLS 
NPDA-23A 
NPDA-52A 
NPDA-52AL 



BNJMPLSL 
BNJMP23A 
BNJMP52A 
BNJMP52L 



Link Problem Determination Aid (LPDA-2) Data 

Link Segment Level 1 
Link Problem Determination Aid (LPDA-2) Data 

Link Segment Level 1, alternate 
Link Problem Determination Aid (LPDA) Data 

Link Segment Level 2 



NPDA-52B 
NPDA-52B 
NPDA-52C 



BNJMP52B 
BNJMP522 
BNJMP52B 



Link Status and Test Results 

Link Status and Test Results for LDM 

LPDA-1 Command Menu 

LPDA-2 Command Menu 

Menu 



NPDA-24A 

NPDA-24AL 

NPDA-LPDA1 

NPDA-LPDA2 

NPDA-01A 



Most Recent Events 
Most Recent Statistical Data 
Most Recent Statistical Data 
Most Recent Statistical Data 
Most Recent Statistical Data 



NPDA-41A 
NPDA-51E 
NPDA-51F 
NPDA-51G 
NPDA-51H 



BNJMP24A 
BNJMP24L 
BNJMPLP1 
BNJMPLP2 
BNJMP01A 



Modem and Line Status 

Modem and Line Parameters 
Link Segment Level n 


NPDA-22B, 


page 1 


BNJMPML1 


Modem and Line Status 

Remote Modem Interface-Remote Device 
Status-Link Segment Level n 


NPDA-22B, 


page 2 


BNJMPML2 


Modem and Line Status 
Configuration Summary, Link Segment Level n 


NPDA-22B, 


page 3 


BNJMPML3 



BNJMP41A 
BNJMP51E 
BNJMP51F 
BNJMP51G 
BNJMP51H 



Most Recent Statistical Data 

Most Recent Statistical Data for Printer 

Most Recent Statistical Data for Tape 

Most Recent Traffic Statistics 

Most Recent Traffic Stats for BSC/SS Station 



NPDA-51B 
NPDA-51D 
NPDA-51C 
NPDA-51A 
NPDA-51A 



BNJMP51B 
BNJMP51B 
BNJMP51B 
BNJMP51A 
BNJMP51A 



Most Recent Traffic Stats for 

BSC STA. w/LPDA 
Most Recent Traffic Stats for 

Channel Attached STA. 
Most Recent Traffic Stats for 

Local CTRL 



NPDA-51A 
NPDA-51A 
NPDA-51A 



BNJMP51A 



BNJMP51A 



BNJMP51A 



Most Recent Traffic Stats for SDLC Station 
Most Recent Traffic Stats for 

SDLC STA. w/LPDA 
Multiple Entries for Selected Resource 
Overwrite Map 



NPDA-51A 
NPDA-51A 

NPDA-70A 
(all displays) 



BNJMP51A 
BNJMP51A 

BNJMP70A 
BNJOVERW 



Recommended Action for Selected Event 
Recording and Viewing Filter Status 
Release Level for SNA Controller 
Remote DTE Interface Status 
Remote DTE Interface Status for LDM 



NPDA-BNIxxxyyy 

NPDA-20A.20B 

NPDA-21A 

NPDA-25A 

NPDA-25AL 



BNJMP45A 
BNJMP20A 
BNJMP21A 
BNJMP25A 
BNJMP25A 
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Table 9 (Page 4 of 4). Color Maps for Hardware Monitor Displays 



Display Name 



Display Number 



Color Map 



Remote Self-Test Results 
Remote Self-Test Results for LDM 
Reported Resource Hardware 
Reported Resource Software Product 
Screen Control/Help 
Screen Control/Help 



NPDA-22A 
NPDA-22AL 
NPDA-44B 
NPDA-44B 
NPDA-02A, page 1 
NPDA-02A, page 2 



BNJMP22A 
BNJMP22L 
BNJMP44B 
BNJMP4BS 
BNJMP2A1 
BNJMP2A2 



Sender Hardware Product ID 
Sender Software Product ID 
Statistical Detail 
Statistical Detail 
Statistical Detail Menu 



NPDA-44B 
NPDA-44B 
NPDA-53E 
NPDA-53F 
NPDA-53R 



BNJMP4BH 
BNJMP4BS 
BNJMP53E 
BNJMP53F 
BNJMP43R 



Statistical Detail Menu for BSC 
Statistical Detail Menu for SDLC 
TEST Information Display 
Total Events 
Total Statistical Data 



NPDA-53R 
NPDA-53R 
NPDA-02D 
NPDA-40A 
NPDA-50A 



BNJMP43R 
BNJMP43R 
BNJMP02D 
BNJMP40A 
BNJMP50A 



Transmit Receive Test-Link Segment Level n 
Upstream Member of Token-Ring 
Fault Domain 



NPDA-25B 
NPDA-44B 



BNJMPTRT 
BNJMP4BH 
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Appendix B. Programming-lnterface Macros 



The macros identified in this appendix are provided to allow a customer installation 
to write programs that use the services of NetView. Only those macros identified in 
this appendix should be used to request or receive the services of NetView. 

All of the following macros are provided as product-sensitive programming inter- 
faces. Product-sensitive programming interfaces are defined in "Special Notices" 
on page iii. 

Name Use 

DSICBS Control Block Services 

DSICES Command Entry Services 

DSIDATIM Date and Time 

DSIDEL Delete User-Defined Module 

DSIDKS Disk Services 

DSIFIND Find Long Running Command Storage 

DSIFRE . Free Storage 

DSIGET Get Storage 

DSIKVS Keyword/Value Services 

DSILCS Obtain/Release Control Blocks 

DSILOD Load User-Defined Module 

DSIMBS Message Buffer Services 

DSIMDS Message Definition Services 

DSIMQS Message Queuing Services 

DSIOIS Operator Identification Services 

DSIPAS Parameter/Alias Services 

DSIPOP Remove Long Running Command 

DSIPOS ECB Post Services 

DSIPRS Parsing Services 

DSIPSS Presentation Services 

DSIPUSH Establish Long Running Command 

DSIRDS Resource Definition Services 

DSIRXCOM Access REXX Variables 

DSIRXEBS Get an EVALBLOK 

DSISSS Search Span Name Table Services 

DSISYS Operating System Indicator 

DSIWAT ECB Wait Services 

DSIWCS Write Console Services 
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DSIWLS Write Log Services 

DSIZCSMS CNM Data Services 
DSIZVSMS VSAM Data Services 
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Appendix C. Programming-lnterface Control Blocks and 
Include Files 

Some control blocks and include files are provided as general-use programming 
interfaces, and some control blocks are provided as product-sensitive programming 
interfaces. General-use programming interfaces and product-sensitive program- 
ming interfaces are defined in "Special Notices" on page iii. 

Control Blocks and Include Files That Are General-Use 
Programming Interfaces 

The following control blocks and include files are provided as general-use program- 
ming interfaces: 

Name Use 

DSIC Main HLL C Include File 

DSICCALL HLL C Service Routine Definitions 

DSICCNM HLL C Return Codes 

DSICCONS HLL C Constants 

DSICHLB HLL C Mapping of DSIHLB 

DSICORIG HLL C Origin Block Mapping 

DSICVARC HLL C Varying Length Character Strings 

DSIPCNM HLL PL/I Return Codes 

DSIPCONS HLL PL/I Constants 

DSIPHLB HLL PL/I Mapping of DSIHLB 

DSIPHLLS PL/I Definitions for HLL Service Routines 

DSIPLI Main HLL PL/I Include File 

DSIPORIG HLL PL/I Origin Block Mapping 

Control Blocks That Are Product-Sensitive Programming Interfaces 

The following control blocks are provided as product-sensitive programming inter- 
faces: 

Name Use 

DSIART Authorization and Routing Table 

DSICBH Control Block Header 

DSICWB Command Work Block 

DSIDSB Data Service Block 

DSIDSRB Data Services Request Block 

DSIELB External Logging Block 

DSIIFR Internal Function Request 
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DSILOGDS NetView Log DSECT 

DSIMVT Main Vector Table 

DSIOIT Operator ID Table 

DSIPDB Parse Descriptor Block 

DSISCE System Command Entry 

DSISCT System Command Table (include only) 

DSISNT Span Name Table 

DSISVL Service Routine Vector List (include only) 

DSISWB Service Work Block 

DSITIB Task Information Block 

DSITVB Task Vector Block 

DSIUSE User Exit Parameter List 
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Glossary 



abend. Abnormal end of task. 

abnormal end of task (abend). Termination of a task 
before its completion because of an error condition that 
cannot be resolved by recovery facilities while the task 
is executing. 

ACB. (1) In VTAM, access method control block. 
(2) In NCP, adapter control block. 

ACB name. (1) The name of an ACB macroinstruction. 
(2) A name specified in the ACBNAME parameter of a 
VTAM APPL statement. Contrast with network name. 

accept. For a VTAM application program, to establish 
a session with a logical unit (LU) in response to a CINIT 
request from a system services control point (SSCP). 
The session-initiation request may begin when a ter- 
minal user logs on, a VTAM application program issues 
a macroinstruction, or a VTAM operator issues a 
command. See also acquire (1). 

access method. A technique for moving data between 
main storage and input/output devices. 

access method control block (ACB). A control block 
that links an application program to VSAM or VTAM. 

accounting exit routine. In VTAM, an optional installa- 
tion exit routine that collects statistics about session 
initiation and termination. 

ACF. Advanced Communications Function. 

ACF/NCP. Advanced Communications Function for the 
Network Control Program. Synonym for NCP. 

ACF/SSP. Advanced Communications Function for the 
System Support Programs. Synonym for SSP. 

ACF/VTAM. Advanced Communications Function for 
the Virtual Telecommunications Access Method. 
Synonym for VTAM. 

acquire. (1) For a VTAM application program, to ini- 
tiate and establish a session with another logical unit 
(LU). The acquire process begins when the application 
program issues a macroinstruction. See also accept. 
(2) To take over resources that were formerly con- 
trolled by an access method in another domain, or to 
resume control of resources that were controlled by 
this domain but released. Contrast with release. See 
also resource takeover. 



active. (1) The state a resource is in when it has been 
activated and is operational. Contrast with inactive, 
pending, and inoperative. (2) Pertaining to a major or 
minor node that has been activated by VTAM. Most 
resources are activated as part of VTAM start proc- 
essing or as the result of a VARY ACT command. 

adapter. Hardware card that allows a device, such as 
a PC, to communicate with another device, such as a 
monitor, a printer, or other I/O device. 

adapter control block (ACB). In NCP, a control block 
that contains line control information and the states of 
I/O operations for BSC lines, SS lines, or SDLC links. 



adaptive session pacing. 

session-level pacing. 



Synonym for adaptive 



adaptive session-level pacing. A form of session-level 
pacing in which session components exchange pacing 
windows that may vary in size during the course of a 
session. This allows transmission to adapt dynamically 
to variations in availability and demand of buffers on a 
session by session basis. Session pacing occurs 
within independent stages along the session path 
according to local congestion at the intermediate 
nodes. Synonymous with adaptive session pacing. 
See pacing, session-level pacing, and virtual route 
pacing. 

Advanced Communications Function (ACF). A group of 
IBM licensed programs (principally VTAM, TCAM, NCP, 
and SSP) that use the concepts of Systems Network 
Architecture (SNA), including distribution of function 
and resource sharing. 

alert. (1) In SNA, a record sent to a system problem 
management focal point to communicate the existence 
of an alert condition. (2) In the NetView program, a 
high priority event that warrants immediate attention. 
This data base record is generated for certain event 
types that are defined by user-constructed filters. 

alert sender. The SNA entity, either a physical unit 
(PU) or a control point, that sends or causes a for- 
matted alert to be sent to a focal point. 

alias name. A name defined in a host used to repre- 
sent a logical unit name, logon mode table name, or 
class-of-service name in another network. This name 
is defined to a name translation program when the 
alias name does not match the real name. The alias 
name translation program is used to'associate the real 
and alias names. 

API. Application program interface. 
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application program. ..(1) A program written for or by a 
user that applies to the user's work. (2) A program 
used to connect and communicate with stations in a 
network, enabling users to perform application-oriented 
activities. 

application program interface (API). (1) The formally 
defined programming language interface between an 
IBM system control program or licensed program and 
its user. (2) The interface through which an application 
program interacts with an access method. In VTAM, it 
is the language structure used in control blocks so that 
application programs can reference them and be identi- 
fied to VTAM. 

attaching device. Any device that is physically con- 
nected to a network and can communicate over the 
network. 

authorization exit routine. In VTAM, an optional instal- 
lation exit routine that approves or disapproves 
requests for session initiation. 

automatic logon. (1) A process by which VTAM auto- 
matically creates a session-initiation request to estab- 
lish a session between two logical units (LUs). The 
session will be between a designated primary logical 
unit (PLU) and a secondary logical unit (SLU) that is 
neither queued for nor in session with another PLU. 
See also controlling application program and control- 
ling logical unit. (2) In VM, a process by which a 
virtual machine is initiated by other than the user of 
that virtual machine. For example, the primary VM 
operator's virtual machine is activated automatically 
during VM initialization. 

available- In VTAM, pertaining to a logical unit that is 
active, connected, enabled, and not at its session limit. 



B 



basic conversation. A conversation that supports the 
functions of the basic conversation protocol boundary 
defined by LU 6.2. That format requires data to be sent 
as logical records consisting of a 2-byte length prefix 
followed by the data. See also mapped conversation. 

binary synchronous communication (BSC). (1) Com- 
munication using binary synchronous line discipline. 
(2) A uniform procedure, using a standardized set of 
control characters and control character sequences, for 
synchronous transmission of binary-coded data 
between stations. 



blocking of PIUs. In SNA, an optional function of path 
control that combines multiple path information units 
(PIUs) into a single basic transmission unit (BTU). 

boundary function. (1) A capability of a subarea node 
to provide protocol support for attached peripheral 
nodes, such as: (a) interconnecting subarea path 
control and peripheral path control elements, (b) per- 
forming session sequence numbering for low-function 
peripheral nodes, and (c) providing session-level 
pacing support. (2) The component that provides these 
capabilities. See also boundary node, network 
addressable unit (NAU), peripheral path control, 
subarea node, and subarea path control. 

boundary node. (1) A subarea node with boundary 
function. See subarea node. See also boundary func- 
tion. (2) The programming component that performs 
FID2 (format identification type 2) conversion, channel 
data link control, pacing, and channel or device error 
recovery procedures for a locally attached station. 
These functions are similar to those performed by a 
network control program for an NCP-attached station. 

browse. A way of looking at a file that does not allow 
you to change it. 

BSC. Binary synchronous communication. 

buffer. A portion of storage for temporarily holding 
input or output data. 



call. (1) * (ISO) The action of bringing a computer 
program, a routine, or a subroutine into effect, usually 
by specifying the entry conditions and jumping to an 
entry point. (2) To transfer control to a procedure, 
program, routine, or subroutine. (3) The actions nec- 
essary to make a connection between two stations. 
(4) To attempt to contact a user, regardless of whether 
the attempt is successful. 

call establishment. The complete sequence of events 
necessary to establish a data connection. 

calling. * (ISO) The process of transmitting selection 
signals in order to establish a connection between data 
stations. 

CALLOUT. The logical channel type on which the data 
terminal equipment (DTE) can send a call, but cannot 
receive one. 



BIU segment. In SNA, the portion of a basic informa- 
tion unit (BIU) that is contained within a path informa- 
tion unit (PIU). It consists of either a request/response 
header (RH) followed by all or a portion of a 
request/response unit (RU), or only a portion of an RU. 



CDRM. Cross-domain resource manager. 

channel. * A path along which signals can be sent, for 
example, data channel, output channel. See data 
channel and input/output channel. See also link. 
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channel adapter. A communication controller hard- 
ware unit used to attach the controller to a System/360 
or a System/370 channel. 

channel link. A System/370 I/O channel to control unit 
interface that has an SNA network address. A channel 
link can be either a subarea link or a peripheral link 
and is defined in an NCP generation definition using the 
GROUP, LINE, and PU definition statements. See also 
link and subarea link.- 

channel-attached. (1) Pertaining to the attachment of 
devices directly by input/output channels to a host 
processor. (2) 

Pertaining to devices attached to a controlling unit by 
cables, rather than by telecommunication lines. Con- 
trast with link-attached. Synonymous with local. 

circuit switching. (1) * (ISO) A process that, on 
demand, connects two or more data terminal equip- 
ments (DTEs) and permits the exclusive use of a data 
circuit between them until the connection is released. 
(2) Synonymous with line switching. (3) See also 
message switching and packet switching. 

class of service (COS). In SNA, a designation of the 
path control network characteristics, such as path 
security, transmission priority, and bandwidth, that 
apply to a particular session. The end user designates 
class of service at session initiation by using a sym- 
bolic name that is mapped into a list of virtual routes, 
any one of which can be selected for the session to 
provide the requested level of service. 

CMS. Conversational Monitor System. 

CNM. Communication network management. 

code point. In the NetView/PC program and in the 
NetView program, a 1- or 2-byte hexadecimal value that 
indexes a text string stored at an alert receiver and is 
used by the alert receiver to create displays of alert 
information. 

command. (1) A request from a terminal for the per- 
formance of an operation or the execution of a partic- 
ular program. (2) In SNA, any field set in the 
transmission header (TH), request header (RH), and 
sometimes portions of a request unit (RU), that initiates 
an action or that begins a protocol; for example: (a) 
Bind Session (session-control request unit), a 
command that activates an LU-LU session, (b) the 
change-direction indicator in the RH of the last RU of a 
chain, (c) the virtual route reset window indicator in a 
FID4 transmission header. See also VTAM operator 
command. 

command facility. The component of the NetView 
program that is a base for command processors that 
can monitor, control, automate, and improve the opera- 
tion of a network. 



command list. A list of commands and statements 
designed to perform a specific function for the user. 
Command lists can be written in REXX or in NetView 
Command List Language. 

command procedure. Either a command list or a 
command processor. 

command processor. A user-written module designed 
to perform a specific function. Command processors, 
which can be written in assembler or a high-level lan- 
guage (HLL), are invoked as commands. 

communication control unit. A communication device 
that controls the transmission of data over lines in a 
network. Communication control units include trans- 
mission control units (such as the 2702 Transmission 
Control Unit) and communication controllers (such as 
the 3720 or 3725). 

communication line. Deprecated term for telecommu- 
nication line and transmission line. 

communication management configuration host node. 

The type 5 host processor in a communication manage- 
ment configuration that does all network-control func- 
tions in the network except for the control of devices 
channel-attached to data hosts. Synonymous with com- 
munication management host. Contrast with data host 
node. 

communication management host. Synonym for com- 
munication management configuration host node. Con- 
trast with data host. 

communication network management (CNM). The 

process of designing, installing, operating, and man- 
aging the distribution of information and controls 
among end users of communication systems. 

communication network management (CNM) applica- 
tion program. A VTAM application program that issues 
and receives formatted management services request 
units for physical units. For example, the NetView 
program. 

communication network management (CNM) interface. 

The interface that the access method provides to an 
application program for handling data and commands 
associated with communication system management. 
CNM data and commands are handled across this inter- 
face. 

communication network management (CNM) 
processor. A program that manages one of the func- 
tions of a communications system. A CNM processor is 
executed under control of the NetView program. 

component. Any part of a network other than an 
attaching device, such as an access unit. 
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composite end node (CEN). A group of nodes made up 
of a single type 5 node and its subordinate type 4 nodes 
that together support type 2.1 protocols. To a type 2.1 
node, a CEN appears as one end node. For example, 
NCP and VTAM act as a composite end node. 

configuration. (1) (TC97) The arrangement of a com- 
puter system or network as defined by the nature, 
number, and the chief characteristics of its functional 
units. The term may refer to a hardware or a software 
configuration. (2) The devices and programs that 
make up a system, subsystem, or network. (3) In CCP, 
the arrangement of controllers, lines, and terminals 
attached to an IBM 3710 Network Controller. Also, the 
collective set of item definitions that describe such a 
configuration. 



controlling logical unit. In VTAM, a logical unit with 
which a secondary logical unit (other than an applica- 
tion program) is automatically put in session whenever 
the secondary logical unit is available. A controlling 
logical unit can be either an application program or a 
device-type logical unit. See also automatic logon and 
controlling application program. 

conversation. In SNA, a logical connection between 
two transaction programs using an LU 6.2 session. 
Conversations are delimited by brackets to gain exclu- 
sive use of a session. 

Conversational Monitor System (CMS). A VM applica- 
tion program for general interactive time sharing, 
problem solving, and program development. 



configuration services. In SNA, one of the types of 
network services in the control point (CP) and in the 
physical unit (PU); configuration services activate, 
deactivate, and maintain the status of physical units, 
links, and link stations. Configuration services also 
shut down and restart network elements and modify 
path control routing tables and address-translation 
tables. See also maintenance services, management 
services, network services, and session services. 



CP. (1) Control program. (2) Control point. 

cross-domain. In SNA, pertaining to control of 
resources involving more than one domain. 

cross-domain resource (CDRSC). A resource owned 
by a cross-domain resource manager (CDRM) in 
another domain but known by the CDRM in this domain 
by network name and associated CDRM. 



connected. In VTAM, pertaining to a physical unit (PU) 
or logical unit (LU) that has an active physical path to 
the host processor containing the system services 
control point (SSCP) that controls the PU or LU. 



cross-domain resource manager (CDRM). In VTAM, 
the function in the system services control point (SSCP) 
that controls initiation and termination of cross-domain 
sessions. 



connection. Synonym for physical connection. 



control block. (1) (ISO) A storage area used by a 
computer program to hold control information. (2) In 
the IBM Token-Ring Network, a specifically formatted 
block of information provided from the application 
program to the Adapter Support Interface to request an 
operation. 

control point (CP). (1) A system services control point 
(SSCP) that provides hierarchical control of a group of 
nodes in a network. (2) A control point (CP) local to a 
specific node that provides control of that node, either 
in the absence of SSCP control (for type 2.1 nodes 
engaged in peer to peer communication) or to supple- 
ment SSCP control. 

control program (CP). The VM operating system that 
manages the real processor's resources and is respon- 
sible for simulating System/370s for individual users. 

controller. A unit that controls input/output operations 
for one or more devices. 

controlling application program. In VTAM, an applica- 
tion program with-which a secondary logical unit (other 
than an application program) is automatically put in 
session whenever the secondary logical unit is avail- 
able. See also automatic logon and controlling logical 
unit. 



DASD. Direct access storage device. 

data channel. Synonym for input/output channel. See 
channel. 

data circuit-terminating equipment (DCE). (TC97) The 
equipment installed at the user's premises that pro- 
vides all functions required to establish, maintain, and 
terminate a connection, and the signal conversion and 
coding between the data terminal equipment (DTE) and 
the line. The DCE may be separate equipment or an 
integral part of other equipment. 

data host. Synonym for data host node. Contrast with 
communication management configuration host. 

data host node. In a communication management con- 
figuration, a type 5 host node that is dedicated to proc- 
essing applications and does not control network 
resources, except for its channel-attached or communi- 
cation adapter-attached devices. Synonymous with 
data host. Contrast with communication management 
configuration host node. 

data link. In SNA, synonym for link. 
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data link control (DLC) layer. In SNA, the layer that 
consists of the link stations that schedule data transfer 
over a transmission medium connecting two nodes and 
perform error control for the link connection. Examples 
of data link control are SDLC for serial-by-bit link con- 
nection and data link control for the System/370 
channel. 

data services command processor (DSCP). A compo- 
nent that structures a request for recording and 
retrieving data in the application program's data base 
and for soliciting data from a device in the network. 



operands 
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START A,(B,C), KEYW0RD1=D, KEYW0RD2=-(E,FJ 
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Figure 29. Example of a Language Statement 



data services task (DST). The NetView subtask that 
gathers, records, and manages data in a VSAM file 
and/or a network device that contains network manage- 
ment information. 

data set. The major unit of data storage and retrieval, 
consisting of a collection of data in one of several pre- 
scribed arrangements and described by control infor- 
mation to which the system has access. 

data terminal equipment (DTE). (TC97) That part of a 
data station that serves as a data source, data link, or 
both, and provides for the data communication control 
function according to protocols. 

data types. In the NetView program, a concept to 
describe the organization of panels. Data types are 
defined as alerts, events, and statistics. Data types are 
combined with resource types and display types to 
describe NetView's display organization. See also 
display types and resource types. 

DCE. Data circuit-terminating equipment. 

ddname. Data definition name. 

definite response (DR). In SNA, a value in the form-of- 
response-requested field of the request header. The 
value directs the receiver of the request to return a 
response unconditionally, whether positive or negative, 
to that request. Contrast with exception response and 
no response. 

definition statement. (1) In VTAM, the statement that 
describes an element of the network. (2) In NCP, a 
type of instruction that defines a resource to the NCP. 
See Figure 29, Figure 30, and Figure 31. See also 
macroinstruction. 
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detailed data. Short strings of textual data transported 
in a network management vector transport (NMVT) and 
displayed, without any interpretation or translation, by 
a problem management focal-point program. 

device. An input/output unit such as a terminal, 
display, or printer. See attaching device. 

direct access storage device (DASD). A device in 
which the access time is effectively independent of the 
location of the data. For example, a disk. 



directory. In VM, a control program (CP) disk that 
defines each virtual machine's normal configuration. 

disabled. In VTAM, pertaining to a logical unit (LU) 
that has indicated to its system services control point 
(SSCP) that it is temporarily not ready to establish 
LU-LU sessions. An initiate request for a session with 
a disabled logical unit (LU) can specify that the session 
be queued by the SSCP until the LU becomes enabled. 
The LU can separately indicate whether this applies to 
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its ability to act as a primary logical unit (PLU) or a sec- 
ondary logical unit (SLU). See also enabled and inhib- 
ited. 

display. (1) To present information for viewing, 
usually on a terminal screen or a hard-copy device. 
(2) A device or medium on which information is pre- 
sented, such as a terminal screen. (3) Deprecated 
term for panel. 

display levels. Synonym for display types. 

display types. In the NetView program, a concept to 
describe the organization of panels. Display types are 
defined as total, most recent, user action, and detail. 
Display types are combined with resource types and 
data types to describe NetView's panel organization. 
See data types and resource types. Synonymous with 
display levels.. 

domain. (1) An access method, its application pro- 
grams, communication controllers, connecting lines, 
modems, and attached terminals. (2) In SNA, a system 
services control point (SSCP) and the physical units 
(PUs), logical units (LUs), links, link stations, and all the 
associated resources that the SSCP has the ability to 
control by means of activation requests and deacti- 
vation requests. See system services control point 
domain and rype 2.1 node control point domain. See 
also single-domain network and multiple-domain 
network. 

domain operator. In a multiple-domain network, the 
person or program that controls the operation of the 
resources controlled by one system services control 
point. Contrast with network operator (2). 

double-byte character set (DBCS). A character set, 
such as Kanji, in which each character is represented 
by a two-byte code. 

downstream. In the direction of data flow from the host 
to the end user. Contrast with upstream. 

DRDS. Dynamic reconfiguration data set. 

DSCP. Data services command processor. 

DST. Data services task. 

DSU/CSU. Data service unit/channel service unit. 

DTE. Data terminal equipment. 

dump. (1) Computer printout of storage. (2) To write 
the contents of all or part of storage to an external 
medium as a safeguard against errors or in connection 
with debugging. (3)" (ISO) Data that have been 
dumped. 

dynamic reconfiguration (DR). The process of 
changing the network configuration (peripheral PUs 



and LUs) without regenerating complete configuration 
tables. 

dynamic reconfiguration data set (DRDS). In VTAM, a 
data set used for storing definition data that can be 
applied to a generated communication controller con- 
figuration at the operator's request. A dynamic recon- 
figuration data set can be used to dynamically add PUs 
and LUs, delete PUs and LUs, and move PUs. It is acti- 
vated with the VARY DRDS operator command. See 
also dynamic reconfiguration. 



E/T. Error-to-traffic. 

EBCDIC. * Extended binary-coded decimal inter- 
change code. A coded character set consisting of 8-bit 
coded characters. 

ECB. Event control block. 

ED. Enciphered data. 

element. (1) A field in the network address. (2) The 
particular resource within a subarea identified by the 
element address. See also subarea. 

Emulation Program (EP). An IBM control program that 
allows a channel-attached 3705 or 3725 communication 
controller to emulate the functions of an IBM 2701 Data 
Adapter Unit, an IBM 2702 Transmission Control, or an 
IBM 2703 Transmission Control. See also network 
control program. 

enabled. In VTAM, pertaining to a logical unit (LU) that 
has indicated to its system services control point 
(SSCP) that it is now ready to establish LU-LU sessions. 
The LU can separately indicate whether this prevents it 
from acting as a primary logical unit (PLU) or as a sec- 
ondary logical unit (SLU). See also disabled and inhib- 
ited. 

enciphered data (ED). Data whose meaning is con- 
cealed from unauthorized users. 

end node. A type 2.1 node that does not provide any 
intermediate routing or session services to any other 
node. For example, APPC/PC is an end node. See 
composite end node, node, and fype 2.1 node. 

end user. In SNA, the ultimate source or destination of 
application data flowing through an SNA network. An 
end user may be an application program or a terminal 
operator. 

entry point. An SNA node that provides distributed 
network management support. It may be a type 2, type 
2.1, type 4, or type 5 node. It sends SNA-formatted 
network management data about itself and the 
resources it controls to a focal point for centralized 
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processing, and it receives and executes focal point ini- 
tiated commands to manage and control its resources. 

EP. Emulation Program. 

ER. (1) Explicit route. (2) Exception response. 

error-to-traffic (E/T). The number of temporary errors 
compared to the traffic associated with a resource. 

event. (1) In the NetView program, a record indicating 
irregularities of operation in physical elements of a 
network. (2) An occurrence of significance to a task; 
typically, the completion of an asynchronous operation, 
such as an input/output operation. 

event control block (ECB). A control block used to rep- 
resent the status of an event. 

exception response (ER). In SNA, a value in the form- 
of-response-requested field of a request header (RH). 
An exception response is sent only if a request is unac- 
ceptable as received or cannot be processed. Contrast 
with definite response and no response. See also neg- 
ative response. 

EXEC. In a VM operating system, a user-written 
command file that contains CMS commands, other 
user-written commands, and execution control state- 
ments, such as branches. 

exit routine. Any of several types of special-purpose 
user-written routines. See accounting exit routine, 
authorization exit routine, logon-interpret routine, 
virtual route selection exit routine, EXLST exit routine, 
and RPL exit routine. 

EXLST exit routine. In VTAM, a routine whose address 
has been placed in an exit list (EXLST) control block. 
The addresses are placed there with the EXLST macro- 
instruction, and the routines are named according to 
their corresponding operand; hence DFASY exit 
routine, TPEND exit routine, RELREQ exit routine, and 
so forth. All exit list routines are coded by the VTAM 
application programmer. Contrast with RPL exit 
routine. 



fault domain. In IBM Token-Ring Network problem 
determination, the portion of a ring that is involved with 
an indicated error. 

feature. A particular part of an IBM product that a cus- 
tomer can order separately. 

filter. In the NetView program, a function that limits 
the data that is to be recorded on the data base and 
displayed at the terminal. See recording filter and 
viewing filter. 

flow control. In SNA, the process of managing the rate 
at which data traffic passes between components of the 
network. The purpose of flow control is to optimize the 
rate of flow of message units, with minimum congestion 
in the network; that is, to neither overflow the buffers at 
the receiver or at intermediate routing nodes, nor leave 
the receiver waiting for more message units. See also 
adaptive session-level pacing, pacing, session-level 
pacing, and virtual route pacing. 

focal point. (1) An entry point that provides central- 
ized management and control for other entry points for 
one or more network management categories. (2) In 
the NetView program, the focal point domain is the 
central host domain. It is the central control point for 
any management services element containing control 
of the network management data. 

frame. (1) The unit of transmission in some local area 
networks, including the IBM Token-Ring Network. It 
includes delimiters, control characters, information, 
and checking characters. (2) In SDLC, the vehicle for 
every command, every response, and all information 
that is transmitted using SDLC procedures. 

full-screen mode. A form of panel presentation in the 
NetView program where the contents of an entire ter- 
minal screen can be displayed at once. Full-screen 
mode can be used for fill-in-the-blanks prompting. Con- 
trast with line mode. 



explicit route (ER). In SNA, the path control network 
elements, including a specific set of one or more trans- 
mission groups, that connect two subarea nodes. An 
explicit route is identified by an origin subarea 
address, a destination subarea address, an explicit 
route number, and a reverse explicit route number. 
Contrast with virtual route (VR). See also path and 
route extension. 

extended architecture (XA). An extension to 
System/370 architecture that takes advantage of contin- 
uing high performance enhancements to computer 
system hardware. 



GCS. Group control system. 

generation. The process of assembling and link 
editing definition statements so that resources can be 
identified to all the necessary programs in a network. 

generic alert. Encoded alert information that uses 
code points (defined by IBM and possibly customized 
by users or application programs) stored at an alert 
receiver, such as the NetView program. 

group. In the NetView/PC program, to identify a set of 
application programs that are to run concurrently. 
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group control system (GCS). A component of VM that 
provides multiprogramming and shared memory 
support to virtual machines. It is a saved system 
intended for use with SNA products. 

group control system group. A group of virtual 
machines that share common storage and load the 
same saved-VM system through a control program (CP) 
command or directory entry. 



H 



half-session. In SNA, a component that provides func- 
tion management data (FMD) services, data flow 
control, and transmission control for one of the ses- 
sions of a network addressable unit (NAU). See also 
primary half-session and secondary half-session. 

hard-copy task (HCT). The NetView subtask that con- 
trols the passage of data between the NetView program 
and the hard-copy device. 

hardware monitor. The component of the NetView 
program that helps identify network problems, such as 
hardware, software, and microcode, from a central 
control point using interactive display techniques. 

HCT. Hard-copy task. 

help panel. An online display that tells you how to use 
a command or another aspect of a product. See task 
panel. 

hierarchy. In the NetView program, the resource 
types, display types, and data types that make up the 
organization, or levels, in a network. 

High Performance Option (HPO). A licensed program 
that is an extension of VM/SP. It provides performance 
and operation enhancements for large system environ- 
ments. See Virtual Machine/System Product High Per- 
formance Option. 

high-level language (HLL). A programming language 
that does not reflect the structure of any particular com- 
puter or operating system. For NetView Release 3, the 
high-level languages are PL/I and C. 

HLL. High-level language. 

host node. A node providing an application program 
interface (API) and a common application interface. 
See boundary node, node, peripheral node, subarea 
host node, and subarea node. See also boundary func- 
tion and node type. 

HPO. High Performance Option. 



immediate command. In the NetView program, a 
command (such as GO, CANCEL, or RESET) that can be 
executed while a regular command is being processed. 

inactive. Describes the state of a resource that has not 
been activated or for which the VARY INACT command 
has been issued. Contrast with active. See also inop- 
erative. 



information (I) format. 

transfer. 



A format used for information 



inhibited. In VTAM, pertaining to a logical unit (LU) 
that has indicated to its system services control point 
(SSCP) that it is not ready to establish LU-LU sessions. 
An initiate request for a session with an inhibited LU 
will be rejected by the SSCP. The LU can separately 
indicate whether this applies to its ability to act as a 
primary logical unit (PLU) or as a secondary logical 
unit (SLU). See also enabled and disabled. 

inoperative. The condition of a resource that has been 
active, but is not. The resource may have failed, 
received an INOP request, or is suspended while a 
reactivate command is being processed. See also 
inactive. 

input/output channel. (1) (ISO) In a data processing 
system, a functional unit that handles the transfer of 
data between internal and peripheral equipment. (2) In 
a computing system, a functional unit, controlled by a 
processor, that handles the transfer of data between 
processor storage and local peripheral devices. Syn- 
onymous with data channel. See channel. See also 
link. 

Interactive System Productivity Facility (ISPF). An IBM 

licensed program that serves as a full-screen editor 
and dialogue manager. Used for writing application 
programs, it provides a means of generating standard 
screen panels and interactive dialogues between the 
application programmer and terminal user. 

interface. * A shared boundary. An interface might be 
a hardware component to link two devices or it might 
be a portion of storage or registers accessed by two or 
more computer programs. 

ISPF. Interactive System Productivity Facility. 

item. In CCP, any of the components, such as commu- 
nication controllers, lines, cluster controllers, and ter- 
minals, that comprise an IBM 3710 Network Controller 
configuration. 
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JCL. Job control language. 

job control language (JCL). * A problem-oriented lan- 
guage designed to express statements in a job that are 
used to identify the job or describe its requirements to 
an operating system. 



link connection segment. A portion of the configuration 
that is located between two resources listed consec- 
utively in the service point command service (SPCS) 
query link configuration request list. 

link problem determination aid (LPDA). A series of 
testing procedures initiated by the NetView program or 
NCP that provide modem status, attached device 
status, and the overall quality of a communications link. 



K 



Kanji. An ideographic character set used in Japanese. 
See also double-byte character set. 

Katakana. A phonetic character set used in Japanese. 
It belongs to a single-byte character set. 

keyword. (1) (TC97) A lexical unit that, in certain con- 
texts, characterizes some language construction. (2) * 
One of the predefined words of an artificial language. 
(3) One of the significant and informative words in a 
title or document that describes the content of that doc- 
ument. (4) A name or symbol that identifies a param- 
eter. (5) A part of a command operand that consists of 
a specific character string (such as DSNAME = ). See 
also definition statement and keyword operand. Con- 
trast with positional operand. 

keyword operand. An operand that consists of a 
keyword followed by one or more values (such as 
DSNAME = HELLO). See also definition statement. 
Contrast with positional operand. 

keyword parameter. A parameter that consists of a 
keyword followed by one or more values. 



LAN. An industry-wide acronym for local area 
network. 

line. See communication line. 

line mode. A form of screen presentation in which the 
information is presented a line at a time in the message 
area of the terminal screen. Contrast with full-screen 
mode. 

line switching. Synonym for circuit switching. 

link. In SNA, the combination of the link connection 
and the link stations joining network nodes; for 
example: (1) a System/370 channel and its associated 
protocols, (2) a serial-by-bit connection under the 
control of Synchronous Data Link Control (SDLC). A 
link connection is the physical medium of transmission. 
A link, however, is both logical and physical. Synony- 
mous with data link. See Figure 32 on page 96. 



link status (LS). Information maintained by local and 
remote modems. 

link-attached. Pertaining to devices that are physically 
connected by a telecommunication line. Contrast with 
channel-attached. Synonymous with remote. 

load module. (ISO) A program unit that is suitable for 
loading into main storage for execution; it is usually the 
output of a linkage editor. 

local. Pertaining to a device that is attached to a con- 
trolling unit by cables, rather than by a telecommuni- 
cation line. Synonymous with channel-attached. 

local address. In SNA, an address used in a peripheral 
node in place of an SNA network address and trans- 
formed to or from an SNA network address by the 
boundary function in a subarea node. 

local area network (LAN). (1) A network in which a set 
of devices are connected to one another for communi- 
cation and that can be connected to a larger network. 
See also token ring. (2) A network in which communi- 
cations are limited to a moderately sized geographic 
area such as a single office building, warehouse, or 
campus, and which do not generally extend across 
public rights-of-way. Contrast with wide area network. 

logical record. (1) (TC97) A set of related data or 
words considered to be a record from a logical view- 
point. (2) A unit of information normally pertaining to a 
single subject; a logical record is that user record 
requested of or given to the data management function. 
See also basic conversation. 

logical unit (LU). In SNA, a port through which an end 
user accesses the SNA network and the functions pro- 
vided by system services control points (SSCPs). An 
LU can support at least two sessions— one with an 
SSCP and one with another LU— and may be capable of 
supporting many sessions with other LUs. See also 
network addressable unit (NAU), peripheral LU, phys- 
ical unit (PU), system services control point (SSCP), 
primary logical unit (PLU), and secondary logical unit 
(SLU). 

logical unit (LU) services. In SNA, capabilities in a 
logical unit to: (1) receive requests from an end user 
and, in turn, issue requests to the system services 
control point (SSCP) in order to perform the requested 
functions, typically for session initiation; (2) receive 
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Figure 32. Links and Path Controls 

requests from the SSCP, for example to activate LU-LU 
sessions via Bind Session requests; and (3) provide 
session presentation and other services for LU-LU ses- 
sions. See also physical unit (PU) services. 

logical unit (LU) 6.2: A type of logical unit that sup- 
ports general communication between programs in a 
distributed processing environment. LU 6.2 is charac- 
terized by (1) a peer relationship between session part- 
ners, (2) efficient utilization of a session for multiple 



transactions, (3) comprehensive end-to-end error proc- 
essing, and (4) a generic application program interface 
(API) consisting of structured verbs that are mapped 
into a product implementation. 

logmode table. Synonym for logon mode table. 

logoff. In VTAM, an unformatted session termination 
request. 
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logon. In VTAM, an unformatted session initiation 
request for a session between two logical units. See 
automatic logon and simulated logon. See also 
session-initiation request. 



vices provide facilities for testing links and nodes and 
for collecting and recording error information. See 
also configuration services, management services, 
network services, and session services. 



logon mode. In VTAM, a subset of session parameters 
specified in a logon mode table for communication with 
a logical unit. See also session parameters. 

logon mode table, m VTAM, a set of entries for one or 
more logon modes. Each logon mode is identified by a 
logon mode name. Synonymous with logmode table. 

logon-interpret routine. In VTAM, an installation exit 
routine, associated with an interpret table entry, that 
translates logon information. It may also verify the 
logon. 

LPDA. Link Problem Determination Aid. 

LU. Logical unit. 

LU type. In SNA, the classification of an LU-LU session 
in terms of the specific subset of SNA protocols and 
options supported by the logical units (LUs) for that 
session, namely: 

The mandatory and optional values allowed in the 
session activation request. 

The usage of data stream controls, function man- 
agement headers (FMHs), request unit (RU) param- 
eters, and sense codes. 

Presentation services protocols such as those 
associated with FMH usage. 

LU types 0, 1, 2, 3, 4, 6.1, 6.2, and 7 are defined. 

LU 6.2. Logical unit 6.2. 

LU-LU session. In SNA, a session between two logical 
units (LUs) in an SNA network. It provides communi- 
cation between two end users, or between an end user 
and an LU services component. 

LU-LU session type. A deprecated term for LU type. 



M 



macroinstruction. (1) An instruction that when exe- 
cuted causes the execution of a predefined sequence of 
instructions in the same source language. (2) In 
assembler programming, an assembler language state- 
ment that causes the assembler to process a prede- 
fined set of statements called a macro definition. The 
statements normally produced from the macro defi- 
nition replace the macroinstruction in the program. 
See also definition statement. 

maintenance services. In SNA, one of the types of 
network services in system services control points 
(SSCPs) and physical units (PUs). Maintenance ser- 



major node. In VTAM, a set of resources that can be 
activated and deactivated as a group. See node and 
minor node. 

management services. In SNA, one of the types of 
network services in control points (CPs) and physical 
units (PUs). Management services are the services 
provided to assist in the management of SNA networks, 
such as problem management, performance and 
accounting management, configuration management 
and change management. See also configuration ser- 
vices, maintenance services, network services, and 
session services. 

mapped conversation. A type of conversation in which 
the data to be sent or received can be in a user-defined 
format. A logical unit (LU) that supports mapped con- 
versations converts the user data to a format suitable 
for the basic conversation protocol boundary. See also 
conversation and basic conversation. 

message. (1) (TC97) A group of characters and 
control bit sequences transferred as an entity. (2) In 
VTAM, the amount of function management data (FMD) 
transferred to VTAM by the application program with 
one SEND request. 

message switching. (1) * (ISO) In a data network, the 
process of routing messages by receiving, storing, and 
forwarding complete messages. (2) The technique of 
receiving a complete message, storing, and then for- 
warding it unaltered to its destination. 

migration. Installing a new version or release of a 
program when an earlier version or release is already 
in place. 

minidisk. Synonym for virtual disk. 

minor node. In VTAM, a uniquely-defined resource 
within a major node. See node and major node. 

modem. A device that modulates and demodulates 
signals transmitted over data communication facilities. 
The term is a contraction for modulator-demodulator. 

module. * A program unit that is discrete and identifi- 
able with respect to compiling, combining with other 
units, and loading; for example, the input to or output 
from an assembler, compiler, linkage editor, or execu- 
tive routine. 

monitor, in the IBM Token-Ring Network, the function 
required to initiate the transmission of a token on the 
ring and to provide soft-error recovery in case of lost 
tokens, circulating frames, or other difficulties. The 
capability is present in all ring stations. 
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Multiple Virtual Storage (MVS). An IBM licensed 
program whose full name is the Operating 
System/Virtual Storage (OS/VS) with Multiple Virtual 
Storage/System Product for System/370. It is a soft- 
ware operating system controlling the execution of pro- 
grams. 

Multiple Virtual Storage for Extended Architecture 
(MVS/XA). An IBM licensed program whose full name 
is the Operating System/Virtual Storage (OS/VS) with 
Multiple Virtual Storage/System Product for Extended 
Architecture. Extended architecture allows 31-bit 
storage addressing. MVS/XA is a software operating 
system controlling the execution of programs. 

multiple-domain network. In SNA, a network with more 
than one system services control point (SSCP). Con- 
trast with single-domain network. 

multitasking. The ability of an operating system to run 
several programs concurrently. 

MVS. Multiple Virtual Storage. 



NetVlew-NetView task (NNT). The task under which a 
cross-domain NetView operator session runs. See 
operator station task. 

NetView/PC. A PC-based IBM licensed program 
through which application programs can be used to 
monitor, manage, and diagnose problems in IBM 
Token-Ring networks, non-SNA communication 
devices, and voice networks. 

network. (1) (TC97) An interconnected group of 
nodes. (2) In data processing, a user application 
network. See path control network, public network, 
SNA network, and user-application network. 

network address. In SNA, an address, consisting of 
subarea and element fields, that identifies a link, a link 
station, or a network addressable unit. Subarea nodes 
use network addresses; peripheral nodes use local 
addresses. The boundary function in the subarea node 
to which a peripheral node is attached transforms local 
addresses to network addresses and vice versa. See 
local address. See also network name. 



MVS/ESA. Multiple Virtual Storage/Enterprise 
Systems Architecture. 

MVS/XA. Multiple Virtual Storage for Extended Archi- 
tecture. 



N 



NAU. Network addressable unit. 

NCCF. Network Communications Control Facility. 

NCP. (1) Network Control Program (IBM licensed 
program). Its full name is Advanced Communications 
Function for the Network Control Program. Synony- 
mous with ACF/NCP. (2) Network control program 
(general term). 

negative response (NR). In SNA, a response indicating 
that a request did not arrive successfully or was not 
processed successfully by the receiver. Contrast with 
positive response. See exception response. 

NetView. A system 370-based IBM licensed program 
used to monitor a network, manage it, and diagnose its 
problems. 

NetView command list language. An interpretive lan- 
guage unique to the NetView program that is used to 
write command lists. 

NetView help desk.. In the NetView program, an online 
information facility that guides the help desk operator 
through problem management procedures. 



network addressable unit (NAU). In SNA, a logical unit, 
a physical unit, or a system services control point. It is 
the origin or the destination of information transmitted 
by the path control network. Each NAU has a network 
address that represents it to the path control network. 
See also network name, network address, and path 
control network. 

Network Communications Control Facility (NCCF). An 

IBM licensed program that is a base for command 
processors that can monitor, control, automate, and 
improve the operations of a network. Its function is 
included and enhanced in NetView's command facility. 

network control program. A program, generated by 
the user from a library of IBM-supplied modules, that 
controls the operation of a communication controller. 

Network Control Program (NCP). An IBM licensed 
program that provides communication controller 
support for single-domain, multiple-domain, and inter- 
connected network capability. Its full name is 
Advanced Communications Function for the Network 
Control Program. 

network log. A file that contains all messages proc- 
essed by the NetView program. 

network management vector transport (NMVT). A 

management services request/response unit (RU) that 
flows over an active session between physical unit 
management services and control point management 
services (SSCP-PU session). 

network name. (1) In SNA, the symbolic identifier by 
which end users refer to a network addressable unit 
(NAU), a link, or a link station. See also network 
address. (2) In a multiple-domain network, the name 
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of the APPL statement defining a VTAM application 
program is its network name and it must be unique 
across domains. Contrast with ACB name. See unin- 
terpreted name. 

network operator. (1) A person or program respon- 
sible for controlling the operation of all or part of a 
network. (2) The person or program that controls all 
the domains in a multiple-domain network. Contrast 
with domain operator. 

Network Problem Determination Application (NPDA). 

An IBM licensed program that helps you identify 
network problems, such as hardware, software, and 
microcode, from a central control point using interac- 
tive display techniques. It runs as an NCCF communi- 
cation network management (CNM) application 
program. Its function is included and enhanced in 
NetView's hardware monitor. 

network services (NS). In SNA, the services within 
network addressable units (NAUs) that control network 
operation through SSCP-SSCP, SSCP-PU, and SSCP-LU 
sessions. See configuration services, maintenance 
services, management services, and session services. 

NMVT. Network management vector transport. 

NNT. NetView-NetView task. 



online. Stored in a computer and accessible from a 
terminal. 

operand. (1) (ISO) An entity on which an operation is 
performed. (2) * That which is operated upon. An 
operand is usually identified by an address part of an 
instruction. (3) Information entered with a command 
name to define the data on which a command 
processor operates and to control the execution of the 
command processor. (4) An expression to whose 
value an operator is applied. See also definition state- 
ment, keyword, keyword parameter, and parameter. 

operator. (1) In a language statement, the lexical 
entity that indicates the action to be performed on oper- 
ands. (2) A person who operates a machine. See 
network operator. See also definition statement. 

operator station task (OST). The NetView task that 
establishes and maintains the online session with the 
network operator. There is one operator station task 
for each network operator who logs on to the NetView 
program. See NetView-NetView task. 

OST. Operator station task. 



no response. In SNA, a value in the form-of-response- 
requested field of the request header (RH) indicating 
that no response is to be returned to the request, 
whether or not the request is received and processed 
successfully. Contrast with definite response and 
exception response. 

node. (1) In SNA, an endpoint of a link or junction 
common to two or more links in a network. Nodes can 
be distributed to host processors, communication con- 
trollers, cluster controllers, or terminals. Nodes can 
vary in routing and other functional capabilities. See 
boundary node, host node, peripheral node, and 
subareanode. (2) In VTAM, a point in a network 
defined by a symbolic name. See major node and 
minor node. 

node name. In VTAM, the symbolic name assigned to 
a specific major or minor node during network defi- 
nition. 

node type. In SNA, a designation of a node according 
to the protocols it supports and the network address- 
able units (NAUs) that it can contain. Five types are 
defined: 1, 2.0, 2.1, 4, and 5. Type 1, type 2.0, and type 
2.1 nodes are peripheral nodes; type 4 and type 5 
nodes are subarea nodes. See also type 2.1 node. 

NPDA. Network Problem Determination Application. 



pacing. In SNA, a technique by which a receiving com- 
ponent controls the rate of transmission of a sending 
component to prevent overrun or congestion. See 
session-level pacing, send pacing, and virtual route 
(VR) pacing. See also flow control. 

pacing response. In SNA, an indicator that signifies a 
receiving component's readiness to accept another 
pacing group; the indicator is carried in a response 
header (RH) for session-level pacing, and in a trans- 
mission header (TH) for virtual route pacing. 

packet mode operation. Synonym for packet switching. 

packet switching. (1) (ISO) The process of routing 
and transferring data by means of addressed packets 
so that a channel is occupied only during the trans- 
mission of a packet. On completion of the trans- 
mission, the channel is made available for the transfer 
of other packets. (2) Synonymous with packet mode 
operation. See also circuit switching. 

page. (1) The portion of a panel that is shown on a 
display surface at one time. (2) To move back and 
forth among the pages of a multiple-page panel. See 
also scroll. (3) (ISO) In a virtual storage system, a 
fixed-length block that has a virtual address and that 
can be transferred between real storage and auxiliary 
storage. (4) To transfer instructions, data, or both 
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between real storage and external page or auxiliary 
storage. 

panel. (1) A formatted display of information that 
appears on a terminal screen. See also help panel and 
task panel. Contrast with screen. (2) In computer 
graphics, a display image that defines the locations and 
characteristics of display fields on a display surface. 

parameter. (1) (ISO) A variable that is given a con- 
stant value for a specified application and that may 
denote the application. (2) An item in a menu for 
which the user specifies a value or for which the 
system provides a value when the menu is interpreted. 
(3) Data passed to a program or procedure by a user 
or another program, namely as an operand in a lan- 
guage statement, as an item in a menu, or as a shared 
data structure. See also keyword, keyword parameter, 
and operand. 

partitioned data set (PDS). A data set in direct access 
storage that is divided into partitions, called members, 
each of which can contain a program, part of a 
program, or data. 

path. (1) In SNA, the series of path control network 
components (path control and data link control) that are 
traversed by the information exchanged between two 
network addressable units (NAUs). See also explicit 
route (BR), route extension, and virtual route (VR). 
(2) In VTAM when defining a switched major node, a 
potential dial-out port that can be used to reach that 
node. (3) In the NetView/PC program, a complete line 
in a configuration that contains all of the resources in 
the service point command service (SPCS) query link 
configuration request list. 

path control (PC). The function that routes message 
units between network addressable units (NAUs) in the 
network and provides the paths between them. It con- 
verts the BlUs from transmission control (possibly seg- 
menting them) into path information units (PIUs) and 
exchanges basic transmission units (BTUs) and one or 
more PIUs with data link control. Path control differs 
for peripheral nodes, which use local addresses for 
routing, and subarea nodes, which use network 
addresses for routing. See peripheral path control and 
subarea path control. See also link, peripheral node, 
and subarea node. 

path control (PC) layer. In SNA, the layer that 
manages the sharing of link resources of the SNA 
network and routes basic information units (BlUs) 
through it. See also BIU segment, blocking of PIUs, 
data link control layer, and transmission control layer. 

path control (PC) network, in SNA, the part of the SNA 
network that includes the data link control and path 
control layers. See SNA network and user application 
network. See also boundary function. 



path information unit (PIU). In SNA, a message unit 
consisting of a transmission header (TH) alone, or of a 
TH followed by a basic information unit (BIU) or a BIU 
segment. See also transmission header. 

PC. (1) Path control. (2) Personal Computer. Its full 
name is the IBM Personal Computer. 

PCID. Procedure-correlation identifier. 

performance class. In the NetView program, a 
description of an objective or commitment of perform- 
ance. It consists of a performance class name, 
boundary definitions, response time definition, 
response time ranges, and response time percentage 
objectives. Sessions may be assigned performance 
classes. 

peripheral host node. A node that provides an applica- 
tion program interface (API) for running application 
programs but does not provide SSCP functions and is 
not aware of the network configuration. The peripheral 
host node does not provide subarea node services. It 
has boundary function provided by its adjacent 
subarea. See boundary node, host node, node, periph- 
eral node, subarea host node, and subarea node. See 
also boundary function and node type. 

peripheral LU. In SNA, a logical unit representing a 
peripheral node. 

peripheral node. In SNA, a node that uses local 
addresses for routing and therefore is not affected by 
changes in network addresses. A peripheral node 
requires boundary-function assistance from an adja- 
cent subarea node. A peripheral node is a physical 
unit (PU) type 1, 2.0, or 2.1 node connected to a 
subarea node with boundary function within a subarea. 
See boundary node, host node, node, peripheral host 
node, subarea host node, and subarea node. See also 
boundary function and node type. 

peripheral path control. The function in a peripheral 
node that routes message units between units with 
local addresses and provides the paths between them. 
See path control and subarea path control. See also 
boundary function, peripheral node, and subarea node. 

peripheral PU. In SNA, a physical unit representing a 
peripheral node. 

Personal Computer (PC). The IBM Personal Computer 
line of products including the 5150 and subsequent 
models. 

physical connection. In VTAM, a point-to-point con- 
nection or multipoint connection. Synonymous with 
connection. 

physical unit (PU). In SNA, a type of network address- 
able unit (NAU). A physical unit (PU) manages and 
monitors the resources (such as attached links) of a 
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node, as requested by a system services control point 
(SSCP) through an SSCP-PU session. An SSCP acti- 
vates a session with the physical unit in order to indi- 
rectly manage, through the PU, resources of the node 
such as attached links. See also peripheral PU and 
subarea PU. 

physical unit (PU) services. In SNA, the components 
within a physical unit (PU) that provide configuration 
services and maintenance services for SSCP-PU ses- 
sions. See also logical unit (LU) services. 

PLU. Primary logical unit. 

POI. Programmed operator interface. 

positional operand. An operand in a language state- 
ment that has a fixed position. See also definition 
statement. Contrast with keyword operand. 

positive response. A response indicating that a 
request was received and processed. Contrast with 
negative response. 

POST. Power-on self test. A series of diagnostic tests 
that are run each time the computer's power is turned 
on. 

PPT. Primary POI task. 

primary half-session. In SNA, the half-session that 
sends the session activation request. See also primary 
logical unit. Contrast with secondary half-session. 

primary logical unit (PLU). In SNA, the logical unit (LU) 
that contains the primary half-session for a particular 
LU-LU session. Each session must have a PLU and 
secondary logical unit (SLU). The PLU is the unit 
responsible for the bind and is the controlling LU for 
the session. A particular LU may contain both primary 
and secondary half-sessions for different active LU-LU 
sessions. Contrast with secondary logical unit (SLU). 

primary POI task (PPT). The NetView subtask that 
processes all unsolicited messages received from the 
VTAM program operator interface (POI) and delivers 
them to the controlling operator or to the command 
processor. The PPT also processes the initial 
command specified to execute when the NetView 
program is initialized and timer request commands 
scheduled to execute under the PPT. 

problem determination. The process of identifying the 
source of a problem; for example, a program compo- 
nent, a machine failure, telecommunication facilities, 
user or contractor-installed programs or equipment, an 
environment failure such as a power loss, or a user 
error. 

procedure-correlation identifier (PCID). In SNA, a 
value used by a control point to correlate requests and 
replies. 



product-set Identification (PSID). (1) In SNA, a tech- 
nique for identifying the hardware and software pro- 
ducts that implement a network component. (2) A 
management services common subvector that trans- 
ports the information described in definition (1). 

program temporary fix (PTF). A temporary solution or 
bypass of a problem diagnosed by .IBM in a current 
unaltered release of the program. 

program-to-program interface. In the NetView 
program, a facility that allows user programs to send 
data buffers to or receive data buffers from other user 
programs. It also allows system and application pro- 
grams to send alerts to the NetView hardware monitor. 

programmed operator. A VTAM application program 
that is authorized to issue VTAM operator commands 
and receive VTAM operator awareness messages. See 
also solicited messages and unsolicited messages. 

programmed operator interface (POI). A VTAM func- 
tion that allows programs to perform VTAM operator 
functions. 

PSID. Product-set identification. 

PTF. Program temporary fix. 

PU. Physical unit. 

PU-PU flow. In SNA, the exchange between physical 
units (PUs) of network control requests and responses. 

public network. A network established and operated 
by communication common carriers or telecommuni- 
cation Administrations for the specific purpose of pro- 
viding circuit-switched, packet switched, and 
leased-circuit services to the public. Contrast with 
user-application network. 



real name. The name by which a logical unit (LU), 
logon mode table, or class-of-service (COS) table is 
known within the SNA network in which it resides. 

receive pacing. In SNA, the pacing of message units 
that the component is receiving. See also send pacing. 

Recommendation X.21 (Geneva 1980). A Consultative 
Committee on International Telegraph and Telephone 
(CCITT) recommendation for a general purpose inter- 
face between data terminal equipment and data circuit 
equipment for synchronous operations on a public data 
network. 

Recommendation X.25 (Geneva 1980). A Consultative 
Committee on International Telegraph and Telephone 
(CCITT) recommendation for the interface between data 
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terminal equipment and packet-switched data net- 
works. See also packet switching. 

recommended action. Procedures suggested by the 
NetView program that can be used to determine the 
causes of network problems. 

record. (1) (ISO) In programming languages, an 
aggregate that consists of data objects, possibly with 
different attributes, that usually have identifiers 
attached to them. In some programming languages, 
records are called structures. (2) (TC97) A set of data 
treated as a unit. (3) A set of one or more related data 
items grouped for processing. (4) In VTAM, the unit of 
data transmission for record mode. A record repres- 
ents whatever amount of data the transmitting node 
chooses to send. 

recording filter. In the NetView program, the function 
that determines which events, statistics, and alerts are 
stored on a data base. 

regular command. In the NetView program, any VTAM 
or NetView command that is not an immediate 
command and is processed by a regular command 
processor. Contrast with immediate command. 

release. For VTAM, to relinquish control of resources 
(communication controllers or physical units). See also 
resource takeover. Contrast with acquire (2). 

remote. Concerning the peripheral parts of a network 
not centrally linked to the host processor and generally 
using telecommunication lines with public right-of-way. 

request header (RH). In SNA, control information pre- 
ceding a request unit (RU). See also request/ response 
header (RH). 

request/response header (RH). In SNA, control infor- 
mation, preceding a request/response unit (RU), that 
specifies the type of RU (request unit or response unit) 
and contains control information associated with that 
RU. 

reset. On a virtual circuit, reinitialization of data flow 
control. At reset, all data in transit are eliminated. 

resource. (1) Any facility of the computing system or 
operating system required by a job or task, and 
including main storage, input/output devices, the proc- 
essing unit, data sets, and control or processing pro- 
grams. (2) In the NetView program, any hardware or 
software that provides function to the network. 

resource hierarchy. In VTAM, the relationship among 
network resources in which some resources are subor- 
dinate to others as a result of their position in the 
network structure and architecture; for example, the 
logical units (LUs) of a peripheral physical unit (PU) are 
subordinate to that PU, which, in turn, is subordinate to 
the link attaching it to its subarea node. 



resource takeover. In VTAM, action initiated by a 
network operator to transfer control of resources from 
one domain to another. See also acquire (2) and 
release. See takeover. 

resource types. In the NetView program, a concept to 
describe the organization of panels. Resource types 
are defined as central processing unit, channel, control 
unit, and I/O device for one category; and communi- 
cation controller, adapter, link, cluster controller, and 
terminal for another category. Resource types are 
combined with data types and display types to describe 
display organization. See also data types and display 
types. 

response. A reply represented in the control field of a 
response frame. It advises the primary or combined 
station of the action taken by the secondary or other 
combined station to one or more commands. See also 
command. 

response header (RH). In SNA, a header, optionally 
followed by a response unit (RU), that indicates 
whether the response is positive or negative and that 
may contain a pacing response. See also negative 
response, pacing response, and positive response. 

response time. (1) The amount of time it takes after a 
user presses the enter key at the terminal until the 
reply appears at the terminal. (2) For response time 
monitoring, the time from the activation of a transaction 
until a response is received, according to the response 
time definition coded in the performance class. 

response time monitor (RTM). A feature available with 
certain hardware devices to allow measurement of 
response times, which may be collected and displayed 
by the NetView program. 

Restructured Extended Executor (REXX). An interpre- 
tive language used to write command lists. 

return code. * A code [returned from a program] used 
to influence the execution of succeeding instructions. 

REXX. Restructured Extended Executor. 

RH. Request/response header. 

ring. A network configuration where a series of 
attaching devices are connected by unidirectional 
transmission links to form a closed path. 

route. See explicit route and virtual route. 

route extension (REX). In SNA, the path control 
network components, including a peripheral link, that 
make up the portion of a path between a subarea node 
and a network addressable unit (NAU) in an adjacent 
peripheral node. See also path, explicit route (ER) and 
virtual route (VR). 
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RPL exit routine. In VTAM, an application program exit 
routine whose address has been placed in the EXIT 
field of a request parameter list (RPL). VTAM invokes 
the routine to indicate that an asynchronous request 
has been completed. See EXLST exit routine. 

RTM. Response time monitor. 



scanner. (1) A device capable of electronically 
reviewing amounts of data and translating the data into 
a machine readable form. (2) For the 3725 communi- 
cation controller, a processor dedicated to controlling a 
small number of telecommunication lines. It provides 
the connection between the line interface coupler hard- 
ware and the central control unit. 

scope of commands. In the NetView program, the 
facility that provides the ability to assign different 
responsibilities to various operators. 

screen. An illuminated display surface; for example, 
the display surface of a CRT or plasma panel. Contrast 
with panel. 

scroll. To move all or part of the display image verti- 
cally to display data that cannot be observed within a 
single display image. See also page (2). 

SDLC. Synchronous Data Link Control. 

secondary half-session. In SNA, the half-session that 
receives the session-activation request. See also sec- 
ondary logical unit (SLU). Contrast with primary half- 
session. 

secondary logical unit (SLU). In SNA, the logical unit 
(LU) that contains the secondary half-session for a par- 
ticular LU-LU session. An LU may contain secondary 
and primary half-sessions for different active LU-LU 
sessions. Contrast with primary logical unit (PLU). 

secondary logical unit (SLU) key. A key-encrypting key 
used to protect a session cryptography key during its 
transmission to the secondary half-session. 

segment. (1) In the IBM Token-Ring Network, a 
section of cable between components or devices on the 
network. A segment may consist of a single patch 
cable, multiple patch cables connected together, or a 
combination of building cable and patch cables con- 
nected together. (2) See link connection segment. 

send pacing. In SNA, pacing of message units that a 
component is sending. See also receive pacing. 

Service Level Reporter (SLR). A licensed program that 
generates management reports from data sets such as 
System Management Facility (SMF) files. 



service point (SP). An entry point that supports appli- 
cations that provide network management for 
resources not under the direct control of itself as an 
entry point. Each resource is either under the direct 
control of another entry point or not under the direct 
control of any entry point. A service point accessing 
these resources is not required to use SNA sessions 
(unlike a focal point). A service point is needed when 
entry point support is not yet available for some 
network management function. 

service point command service (SPCS). An extension 
of the command facility in the NetView program that 
allows the host processor to communicate with a 
service point by using the communication network 
management (CNM) interface. 

session. In SNA, a logical connection between two 
network addressable units (NAUs) that can be acti- 
vated, tailored to provide various protocols, and deacti- 
vated, as requested. Each session is uniquely 
identified in a transmission header (TH) by a pair of 
network addresses, identifying the origin and destina- 
tion NAUs of any transmissions exchanged during the 
session. See half-session, LU-LU session, SSCP-LU 
session, SSCP-PU session, and SSCP-SSCP session. 
See also LU-LU session type and PU-PU flow. 

session awareness (SAW) data. Data collected by the 
NetView program about a session that includes the 
session type, the names of session partners, and infor- 
mation about the session activation status. It is col- 
lected for LU-LU, SSCP-LU, SSCP-PU, and SSCP-SSCP 
sessions and for non-SNA terminals not supported by 
NTO. It can be displayed in various forms, such as 
most recent sessions lists. 

session data. Data about a session, collected by the 
NetView program, that consists of session awareness 
data, session trace data, and session response time 
data. 

session monitor. The component of the NetView 
program that collects and correlates session-related 
data and provides online access to this information. 

session parameters. In SNA, the parameters that 
specify or constrain the protocols (such as bracket pro- 
tocol and pacing) for a session between two network 
addressable units. See also logon mode. 

session services. In SNA, one of the types of network 
services in the control point (CP) and in the logical unit 
(LU). These services provide facilities for an LU or a 
network operator to request that the SSCP initiate or 
terminate sessions between logical units. See config- 
uration services, maintenance services, and manage- 
ment services. 

session-Initiation request. In SNA, an Initiate or logon 
request from a logical unit (LU) to a control point (CP) 
that an LU-LU session be activated. 
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session-level pacing. In SNA, a flow control technique 
that permits a receiver to control the data transfer rate 
(the rate at which it receives request units) on the 
normal flow. It is used to prevent overloading a 
receiver with unprocessed requests when the sender 
can generate requests faster than the receiver can 
process them. See also pacing and virtual route 
pacing. 

simulated logon. A session-initiation request gener- 
ated when a VTAM application program issues a 
SIMLOGON macroinstruction. The request specifies a 
logical unit (LU) with which the application program 
wants a session in which the requesting application 
program will act as the primary logical unit (PLU). 

single-domain network, in SNA, a network with one 
system services control point (SSCP). Contrast with 
multiple-domain network. 

SLR. Service Level Reporter. 

SLU. Secondary logical unit. 

SMF. System management facility. 

SNA. Systems Network Architecture. 

SNA network. The part of a user-application network 
that conforms to the formats and protocols of Systems 
Network Architecture. It enables reliable transfer of 
data among end users and provides protocols for con- 
trolling the resources of various network configura- 
tions. The SNA network consists of network 
addressable units (NAUs), boundary function compo- 
nents, and the path control network. 

SNBU. Switched network backup. 

SP. Service point. 

span. In the NetView program, a user-defined group of 
network resources within a single domain. Each major 
or minor node is defined as belonging to one or more 
spans. See also span of control. 

span of control. The total network resources over 
which a particular network operator has control. All 
the network resources listed in spans associated 
through profile definition with a particular network 
operator are within that operator's span of control. 

SPCS. Service point command service. 

SS. Start-stop. 

SSCP. System services control point. 

SSCP-LU session. In SNA, a session between a 
system services control point (SSCP) and a logical unit 
(LU); the session enables the LU to request the SSCP to 
help initiate LU-LU sessions. 



SSCP-PU session. In SNA, a session between a 
system services control point (SSCP) and a physical 
unit (PU); SSCP-PU sessions allow SSCPs to send 
requests to and receive status information from indi- 
vidual nodes in order to control the network configura- 
tion. 

SSCP-SSCP session. In SNA, a session between the 
system services control point (SSCP) in one domain 
and the SSCP in another domain. An SSCP-SSCP 
session is used to initiate and terminate cross-domain 
LU-LU sessions. 

SSP. System Support Programs (IBM licensed 
program). Its full name is Advanced Communications 
Function for System Support Programs. Synonymous 
with ACF/SSP. 

ST. Session configuration screen abbreviation. 

statement. A language syntactic unit consisting of an 
operator, or other statement identifier, followed by one 
or more operands. See definition statement. 

station. (1) One of the input or output points of a 
network that uses communication facilities; for 
example, the telephone set in the telephone system or 
the point where the business machine interfaces with 
the channel on a leased private line. (2) One or more 
computers, terminals, or devices at a particular 
location. 

subarea. A portion of the SNA network consisting of a 
subarea node, any attached peripheral nodes, and their 
associated resources. Within a subarea node, all 
network addressable units, links, and adjacent link 
stations (in attached peripheral or subarea nodes) that 
are addressable within the subarea share a common 
subarea address and have distinct element addresses. 

subarea host node. A host node that provides both 
subarea function and an application program interface 
(API) for running application programs. It provides 
system services control point (SSCP) functions, 
subarea node services, and is aware of the network 
configuration. See boundary node, communication 
management configuration host node, data host node, 
host node, node, peripheral node, and subarea node. 
See also boundary function and node type. 

subarea link. In SNA, a link that connects two subarea 
nodes. See channel link and link. 

subarea node. In SNA, a node that uses network 
addresses for routing and whose routing tables are 
therefore affected by changes in the configuration of 
the network. Subarea nodes can provide gateway func- 
tion, and boundary function support for peripheral 
nodes. Type 4 and type 5 nodes are subarea nodes. 
See boundary node, host node, node, peripheral node, 
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and subarea host node. See also boundary function 
and node type. 

subarea path control. The function in a subarea node 
that routes message units between network address- 
able units (NAUs) and provides the paths between 
them. See path control and peripheral path control. 
See also boundary function, peripheral node, and 
subarea node. 



subarea PU. 

node. 



In SNA, a physical unit (PU) in a subarea 



subsystem. A secondary or subordinate system, 
usually capable of operating independent of, or asyn- 
chronously with, a controlling system. 

subvector. A subcomponent of the MAC major vector. 

supervisor. The part of a control program that coordi- 
nates the use of resources and maintains the flow of 
processing unit operations. 

suppression character. In the NetView program, a 
user-defined character that is coded at the beginning of 
a command list statement or a command to prevent the 
statement or command from appearing on the opera- 
tor's terminal screen or in the network log. 

switched network. Any network in which connections 
are established by closing switches, for example, by 
dialing. 

switched network backup (SNBU). An optional facility 
that allows a user to specify, for certain types of PUs, a 
switched line to be used as an alternate path if the 
primary line becomes unavailable or unusable. 

Synchronous Data Link Control (SDLC). A discipline 
for managing synchronous, code-transparent, 
serial-by-bit information transfer over a link con- 
nection. Transmission exchanges may be duplex or 
half-duplex over switched or nonswitched links. The 
configuration of the link connection may be point-to- 
point, multipoint, or loop. SDLC conforms to subsets of 
the Advanced Data Communication Control Procedures 
(ADCCP) of the American National Standards Institute 
and High-Level Data Link Control (HDLC) of the Interna- 
tional Standards Organization. 

system management facility (SMF). A standard feature 
of MVS that collects and records a variety of system 
and job-related information. 

system services control point (SSCP). In SNA, a 
central location point within an SNA network for man- 
aging the configuration, coordinating network operator 
and problem determination requests, and providing 
directory support and other session services for end 
users of the network. Multiple SSCPs, cooperating as 
peers, can divide the network into domains of control, 



with each SSCP having a hierarchical control relation- 
ship to the physical units and logical units within its 
domain. 

system services control point (SSCP) domain. The 

system services control point and the physical units 
(PUs), logical units (LUs), links, link stations and all the 
resources that the SSCP has the ability to control by 
means of activation requests and deactivation 
requests. 

System Support Programs (SSP). An IBM licensed 
program, made up of a collection of utilities and small 
programs, that supports the operation of the NCP. 

Systems Network Architecture (SNA). The description 
of the logical structure, formats, protocols, and opera- 
tional sequences for transmitting information units 
through and controlling the configuration and operation 
of networks. 



takeover. The process by which the failing active sub- 
system is released from its extended recovery facility 
(XRF) sessions with terminal users and replaced by an 
alternate subsystem. See resource takeover. 

task. A basic unit of work to be accomplished by a 
computer. The task is usually specified to a control 
program in a multiprogramming or multiprocessing 
environment. 

task panel. Online display from which you communi- 
cate with the program in order to accomplish the pro- 
gram's function, either by selecting an option provided 
on the panel or by entering an explicit command. See 
help panel. 

telecommunication line. Any physical medium such as 
a wire or microwave beam, that is used to transmit 
data. Synonymous with transmission line. 

terminal. A device that is capable of sending and 
receiving information over a link; it is usually equipped 
with a keyboard and some kind of display, such as a 
screen or a printer. 

TH. Transmission header. 

threshold. In the NetView program, refers to a per- 
centage value set for a resource and compared to a 
calculated error-to-traffic ratio. 

threshold analysis and remote access. (1) A compo- 
nent of the NetView program that can notify a central 
operator about network problems and errors. It pro- 
vides remote control of IBM 3600 and 4700 controllers 
and can record, analyze, and display performance and 
status data on IBM 3600 and 4700 Finance Communi- 
cations Systems. (2) The feature of the back-level 
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NPDA licensed program that performs some of these 
functions. 

time sharing option (TSO). An optional configuration of 
the operating system that provides conversational time 
sharing from remote stations. 

token. A sequence*of bits passed from one device to 
another along the token ring. When the token has data 
appended to it, it becomes a frame. 

token ring. A network with a ring topology that passes 
tokens from one attaching device to another. For 
example, the IBM Token-Ring Network. 

transaction program. (1) A program that is executed 
by or within an application program and performs ser- 
vices related to the processing of a transaction. (2) In 
VTAM, a program that performs services related to the 
processing of a transaction. One or more transaction 
programs may operate within a VTAM application 
program that is using the VTAM application program 
interface (API). In that situation, the transaction 
program would request services from the application 
program, using protocols defined by that application 
program. The application program, in turn, could 
request services from VTAM by issuing the APPCCMD 
macroinstruction. 

transmission control (TC) layer. In SNA, the layer 
within a half-session that synchronizes and paces 
session-level data traffic, checks session sequence 
numbers of requests, and enciphers and deciphers 
end-user data. Transmission control has two compo- 
nents: the connection point manager and session 
control. See also half-session. 

transmission header (TH). In SNA, control information, 
optionally followed by a basic information unit (BIU) or 
a BIU segment, that is created and used by path control 
to route message units and to control their flow within 
the network. See also path information unit. 



u 



uninterpreted name. In SNA, a character string that a 
system services control point (SSCP) is able to convert 
into the network name of a logical unit (LU). Typically, 
an uninterpreted name is used in a logon or Initiate 
request from a secondary logical unit (SLU) to identify 
the primary logical unit (PLU) with which the session is 
requested. 

upstream. In the direction of data flow from the end 
user to the host. Contrast with downstream. 

user. Anyone who requires the services of a com- 
puting system. 

user exit. A point in an IBM-supplied program at which 
a user routine may be given control. 

user exit routine. A user-written routine that receives 
control at predefined user exit points. User exit rou- 
tines can be written in assembler or a high-level lan- 
guage (HLL). 

user table. In TPNS, one or more text data entries con- 
tained in a table format, which may be referred to for 
logic testing and message generation. 

user-application network. A configuration of data proc- 
essing products, such as processors, controllers, and 
terminals, established and operated by users for the 
purpose of data processing or information exchange, 
which may use services offered by communication 
common carriers or telecommunication Adminis- 
trations. Contrast with public network. 

using node. (1) In NCP, the NCP in the host's domain 
that reports a link error condition. (2) For the 
command facility of the NetView program and for 
NCCF, the ID parameter of certain network control com- 
mands. 



transmission line. Synonym for telecommunication 
line. 

TSO. Time sharing option. 

type 2.1 node (T2.1 node). A node that can attach to an 
SNA network as a peripheral node using the same pro- 
tocols as type 2.0 nodes. Type 2.1 nodes can be 
directly attached to one another using peer-to-peer pro- 
tocols. See end node, node, and subarea node. See 
also node type. 

type 2.1 node (T2.1 node) control point domain. The 

CP, its logical units <LUs), links, link stations, and ail 
resources that it activates and deactivates. 



value. (1) (TC97) A specific occurrence of an attri- 
bute, for example, "blue" for the attribute "color." (2) A 
quantity assigned to a constant, a variable, a param- 
eter, or a symbol. 

variable. In the NetView program, a character string 
beginning with & that is coded in a command list and is 
assigned a value during execution of the command list 

vector. The MAC frame information field. 

viewing filter. In the NetView program, the function 
that allows a user to select the data to be displayed on 
a terminal. All other stored data is blocked. 
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virtual disk. (1) A logical subdivision (or all) of a phys- 
ical disk pack in the VM operating system that has its 
own virtual device address, consecutive virtual cylin- 
ders, and a volume table of contents (VTOC) or disk 
label identifier. (2) Synonymous with minidisk. 

virtual machine. A functional simulation of a computer 
and its associated devices. 

Virtual Machine (VM). A licensed program whose full 
name is the Virtual Machine/System Product (VM/SP). 
It is a software operating system that manages the 
resources of a real processor to provide virtual 
machines to end users. As a time-sharing system 
control program, it consists of the virtual machine 
control program (CP), the conversational monitor 
system (CMS), the group control system (GCS), and the 
interactive problem control system (IPCS). 

Virtual Machine/System Product High Performance 
Option. An IBM licensed program that can be installed 
and executed in conjunction with VM/System Product to 
extend the capabilities of the VM/System Product with 
programming enhancements, support for microcode 
assists, and additional functions. The VM/SP High Per- 
formance Option program package is not executable by 
itself. It requires installation of VM/System Product or 
an equivalent IBM-licensed program. 

virtual route (VR). In SNA, a logical connection (1) 
between two subarea nodes that is physically realized 
as a particular explicit route, or (2) that is contained 
wholly within a subarea node for intranode sessions. A 
virtual route between distinct subarea nodes imposes a 
transmission priority on the underlying explicit route, 
provides flow control through virtual-route pacing, and 
provides data integrity through sequence numbering of 
path information units (PIUs). See also explicit route 
(ER), path, and route extension. 

virtual route (VR) pacing. In SNA, a flow control tech- 
nique used by the virtual route control component of 
path control at each end of a virtual route to control the 
rate at which path information units (PIUs) flow over the 
virtual route. VR pacing can be adjusted according to 
traffic congestion in any of the nodes along the route. 
See also pacing and session-level pacing. 

virtual route selection exit routine. In VTAM, an 
optional installation exit routine that modifies the list of 
virtual routes associated with a particular class of 
service before a route is selected for a requested 
LU-LU session. 

Virtual Storage Access Method (VSAM). An access 
method for direct or sequential processing of fixed and 
variable-length records on direct access devices. The 
records in a VSAM data set or file can be organized in 
logical sequence by a key field (key sequence), in the 



physical sequence in which they are written on the data 
set or file (entry-sequence), or by relative-record 
number. 

Virtual Storage Extended (VSE). An IBM licensed 
program whose full name is the Virtual Storage 
Extended/Advanoed Function. It is a software oper- 
ating system controlling the execution of programs. 

Virtual Telecommunications Access Method (VTAM). 

An IBM licensed program that controls communication 
and the flow of data in an SNA network. It provides 
single-domain, multiple-domain, and interconnected 
network capability. 

VM. Virtual Machine. Its full name is Virtual 
Machine/System Product. Synonymous with VM/SP. 



VM/SP. 

VM. 



Virtual Machine/System Product. Synonym for 



VM/XA. Virtual Machine/Extended Architecture. 

VR. Virtual route. 

VSAM. Virtual Storage Access Method. 

VSE. Virtual Storage Extended. Synonymous with 
VSE/AF. 

VSE/AF. Virtual Storage Extended/Advanced Function. 
Synonym for VSE. 

VTAM. Virtual Telecommunications Access Method 
(IBM licensed program). Its full name is Advanced 
Communications Function for the Virtual Telecommuni- 
cations Access Method. Synonymous with ACF/VTAM. 

VTAM operator command. A command used to 
monitor or control a VTAM domain. See also definition 
statement. 



w 



wide area network. A network that provides data com- 
munication capability in geographic areas larger than 
those serviced by local area networks. Wide area net- 
works may extend across public rights-of-way. Con- 
trast with local area network. 

wrap. In general, to go from the maximum to the 
minimum in computer storage. For example, the con- 
tinuation of an operation from the maximum value in 
storage to the first minimal value. 

wrap count. In the NetView program, the number of 
events that can be retained on the data base for a spe- 
cific resource. 
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X.2S. See Recommendation X.25 (Geneva 1980). 
XA. See extended architecture. 
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network, and gathering the necessary data to report a 
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NetView Operation (SC31-6019) provides system pro- 
grammers and experienced network operators a com- 
prehensive explanation of network management using 
the NetView program. Topics include detailed 
command explanation and panel flows, as well as infor- 
mation on how the various components interact with 
each other. 

NetView Command Summary (SX75-0026) is a refer- 
ence card that provides network operators with the 
format of all the commands and the commonly used 
NetView command lists. The commands are listed in 
alphabetical order by component. 

NetView Problem Determination and Diagnosis 
(LY43-0001) aids system programmers in identifying a 
NetView problem, classifying it, and describing it to an 
IBM Support Center. 

NetView Problem Determination Supplement for Man- 
agement Services Major Vectors 0001 and 0025 
(LD21-0023) describes major vectors 0001 and 0025 for 
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in problem determination or diagnosis. The supple- 
ment may be used for the generic alert option and 
other problem determination tasks. 

NetView Resource Alerts Reference (SC31-6024) lists 
the messages sent by NetView-supported hardware 
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action codes, event types, message text, and qualifiers. 
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mation than online help provides. 
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NetView Storage Estimates (SK2T-1988) is an interac- 
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requirements for NetView. This tool can be used for 
planning, installation, and tuning purposes. It is 
intended for network planners, system programmers, 
and IBM service personnel. 
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automation concept. This book includes planning infor- 
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and downstream to supported devices. Information 
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ducts that support NetView/PC is also provided. It also 
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are ordering your equipment. 
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(SC31-6004) is a reference for OS/2 programmers who 
use the api/cs and for system programmers who write 
command processors to run under NetView. The API/CS 
provides a means for vendor and other external appli- 
cations to use the communication services of 
NetView/PC. 

NetView/ PC Operation (SC31-6003) describes how to 
operate the program and diagnose problems in 
NetView/PC. 

NetView/PC Quick Reference (SX75-0016) describes all 
of the functions of the F-keys throughout the 
NetView/PC program. 
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VTAM Data Areas for MVS (LY30-5592) 

VTAM Data Areas for VM (LY30-5593) 
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TESTSP 74 



CANCEL option of UNIQUE command 20 

CLISTVAR keyword 74 

CMD command 19 

CMD HIGH 26 

CMDSYN parameter 39 

CMDSYN resource definition statement 40 

CNMI service 3 

CNMRESD source panel example 28 

CNMSEQ DD statement 44 

CNMSJM07 69, 70 

CNMSJM08 sample 69 

CNMSJ018 38, 44 

CNMSVM07 70 
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CNMSVM08 69 
CNMSV018 38, 44 
CNMVARS 18 
CNM944I message 17 
code point 39 

alert description 69 

detail data 69 . 

failure cause 69 

install cause 69 

probable cause 69 

recommended action 69 

user cause 69 
color buffer 56, 59 
color map 

BNJOVERW 56 

map element 57 

repetition factor option 58 

repetition map element 58 

sample 57 

variable row placement option 59 
color maps 

list of 79-82 
color of panel text 13 
command facility console 71 
command global variable 10 
command line 26 
command list 

modifying a 13 

writing a 13 
command list error message 76 
command list variable 3, 37 
command procedure 

invoking VIEW with the MSG option 26 

issuing a command from a 19 
command processor interface 4 
compiled language 9 
concatenated user library 61 
continuation panel 38, 43 
control block 9 

control blocks, list of programming-interface 85 
control program text title 68 
control variable 17, 18 
copying the panel record 39 
CREATE option 76 
customization 2 
customizing hardware monitor displayed data 

alert message 52 

color and highlighting 56 
modifying the color map 57 
prompt highlight token 59 
selecting the color map 56 

modifying hardware monitor panel 
actual panel name versus alias 45 
adding an actual or alias 50 
changing from alias to actual 49 
changing panel text 48 
deleting an actual or alias 49 
determining panel name 45 



customizing hardware monitor displayed data (con- 
tinued) 
overlaying recommended action number 52 
user interface 54 
BNJDNUMB 54 
BNJwwwww 55 
using NMVT support for user-written 
programming 60 
adding or modifying resource type 71 
building generic alert panel 63 
creating user-defined generic code point 68 
defining user table 69 
link-editing the user table 70 
table format 69 

user-defined alert - pregeneric 61 
user-defined alerts - generic 61 
customizing IBM-supplied VPD command list 78 



data file 3 

data services task (DST) 

subtask 4 
DCE 75, 76 
definition statement 14 
designing and implementing your own function 
choosing an application program interface 

ease of creation 9 

logging 11 

maintenance 9 

performance 9 
defining objective 2 
identifying conceptual component 

adding optional task 4 

collecting data 2 

data file 3 

data storage and recording 3 

defining transaction 4 

exit and command 4 

operator command and message 3 

operator presentation 4 

service routine 3 

task structure 4 

user exit 3 
usage scenario 2 
detail data code point 62 
direct NNT session 77 
direct OST session 77 
directory listing of panel names 46 
displayed data, hardware monitor 45 
displaying special attributes 15 
DRD (dynamic reconfiguration deck 77 
DSIELTSK 77 
DSIMDS macro 52, 61 
DSIPOP 20 
DSIPUSH 19, 20 
DST (data services task) 
subtask 4 



114 Customization Guide 



dynamic reconfiguration deck (DRD) 77 

E 

END record 76, 77 

event detail panel 45, 46, 52 

exit 3 

exit routine 9 



FINDNCP command list 74 
focal point NetView for VPD collection 
front-end line switch 73 
full-screen panel, displaying 13 
functional extension 4 
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INITCNFG command list (continued) 

UN field 74 
input field, length of 24 
INPUT keyword 21,23 
input value 14 
input-capable variable 21 
interactive debug capability 9 
interfaces, programming 

See programming interfaces 
inventory data, collecting 75 

K 

Kanji 

coding on a help panel 41 



GCS (group control system) 4 
GENALERT command 62 
generic alert code point 45 
generic alert record 45 
GLOBAL LOADLIB statement 70 
global variable 18, 26 
GLOBALV 18 
GO command 10 
group control system (GCS) 4 

H 

HALT subroutine 21 
hardware monitor 

altering color of text 56 

altering highlighting of text 56 

altering intensity of text 56 

audible alarm 56 

mapping the NMVT 61 

modifying panel 45 

recommended action panel 52 
hardware monitor displayed data 45 
hardware monitor displays 

list of 79-82 
hardware product identifier 54 
HELP command list 40 
hierarchy complete indicator bit 65, 67 
highlighting of panel text 13 

I 

IEBUPDTE utility 50 

IEHPROGM utility 49 

imbed flag 70 

include files, list of programming-interface 

INITCNFG command list 

APPL field 74 

LINE field 74 

RD field 74 

SP field 74 
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link or link segment 

problem determination analysis 73 

returning device data 73 

testing a 73 
link-edit load module name 61 
LINKDATA 73 
LINKDATA command 74 
LINKPD 73 
LINKTEST 73 
LINKTEST command 74 
LOADCL command 9 
LOADLIB 

NPDA 70 

user-defined 70 
local variable, REXX 18 
logging facilities 3 
logging method 11 
LPDA-2 architecture 75 

M 

macros, list of programming-interface 83 
managing additional component 1 
message automation table 76, 77 
message help panel 35 
message panel 38 
migration 60 
MINOR option 19 
modifying existing function 1 
modifying SPCS and NAM command lists 

customization considerations 78 

NAM command list 75 

service point command service (SPCS) 73 

using SPCS commands 73 

vital product data (VPD) collection 
focal point NetView 77 
from a single NetView domain 77 
from a single physical unit 76 
most recent events panel 45, 52, 74- 
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multiplexer 73 

N 

NAM (network asset management) command list 

modifying 78 

VPDACT command list 76 

VPDDCE command list 76 

VPDLOGC command list 76 

VPDPU command list 76 

VPDXDOM command list 76 
named variable 19 
naming convention 

online message panel 38 

primary panel 38 
NCCFIC command list 73 
NETLNK 70 
NETSTRT GCS file 70 
NetView component, definition of 19 
NetView log 17 
NetView panel library 61 
NetView/PC interface program 73 
network asset management (NAM) command list 

modifying 78 

VPDACT command list 76 

VPDDCE command list 76 

VPDLOGC command list 76 

VPDPU command list 76 

VPDXDOM command list 76 
network log 11 
network management data 3 
network management vector transport (NMVT) 60 
network qualified procedure correlation identifier 68 
new management function 1 
new menu option 41 
new panel 

creating a new menu item 41 

insert into flow of existing panels 42 

instructions for structuring 40 

procedure for creating 40 

storing 43 

testing 44 
NMVT (network management vector transport) 60 

o 

online help panel 

color attribute for 14 
highlighting attribute for 14 
online message help panel 
adding 43 
replacing 43 
storing procedure 43 
online panel interface 
creating 35 
creating new panel 

adding a menu item 41 
creating a source, panel 40 
linking into an existing flow 42 



online panel interface (continued) 
creating new panel (continued) 
naming a source panel 40 
writing a source panel 40 
modifying 35 
modifying help panel 

locating a source panel 35 
modifying a source panel 35 
modifying online message panel 39 
online message panel naming convention 38 
procedure for 35 
storing new and modified (or modified) panel 43 
testing newly stored panel 44 
operator command 3 
operator command interface 19 
operator interface 4 
operator presentation 
component 1 
customizing 4 
extending 4 
function 4 
using message 4 
operator station task (OST) 13, 26 
OPID NetView control variable 18 
OPT (optional) subtask 4 
option definition 42, 43 
optional (OPT) subtask 4 
OST (operator station task) 13, 26 
overwriting global variable 18 

P 

panel data set 40 

panel data stream 43 

panel definition statement 17 

panel name, determining 45 

panel variable 16 

panel variables 39 

partial command, predefining a 26 

PAUSE command 10 

physical unit (PU) 75, 76 

preloading 

NetView command list 9 

REXX command list 9 
primary panel 38 
probable cause code point 62 
product-set identification (PSID) 54 
programming interfaces 

defined iii 

list of control blocks 85 

list of include files 85 

list of macros 83 

method of identifying iii 
PROMOTE option of UNIQUE command 20 
prompt highlight token 59 
prompt highlight token table (BNJPROMP) 59 
PSID (product = set identification) 54 
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PU (physical unit) 75, 76 



queuing a command 19 



recommended action number 52 
recommended action panel 45, 46 
record format, building 78 
renamed command 40 
repetition factor option 58 
repetition map element 58 
REQUEST/REPLY PSID architecture 75 
RESDYN command output example 27 
RESET 78 

RESOURCE command 29 
resource type 

adding 71 

modifying 71 
return code 

displaying VIEW 33 

from VIEW 32 
REXX 

local variable 18 
ROLL command 19,38 
roll group 19, 20 
rollable application 13 
rollable component 

creating a 19, 21 

REXX command procedure that drives a 
RUNCMD 73, 74 

s 

secondary extent 55 
secondary extents 40 
sequential data set 39, 44 
service level reporter (SLR) 75, 78 
service point 

application 73 

application command 73 

resource information 73 
service point command service (SPCS) 

command 

LINKDATA 73 
LINKPD 73 
LINKTEST 73 
RUNCMD 73 

command list 73 

definition of 73 
serviceable component identifier 54 
SHOWCODE command list 13, 33 
SLR (service level reporter) 75, 78 
SMF log 3 
SMF logging failure 76 
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SMF record format, changing the 78 
SMF record number 78 
source panel 

building a 40 

creating a 40 

definition of 35 

locating 35 

modifying a 35 

new menu item 42 

replacing an existing panel 40 

sample panel 36 

viewing the 35 

writing a 40 
SPCS (service point command service) 

command 

LINKDATA 73 
LINKPD 73 
LINKTEST 73 
RUNCMD 73 

command list 73 

definition of 73 
specialized disk service 3 
SPLOOKUP command list 74 
START DOMAIN command 77 
START record 76, 77 
START VPDTASK 78 
STARTCNM NPDA 71 
STEPLIB 39, 44 
STOP TASK 71 

storing new or modified panel 43 
SYSIN statement 39, 44 
SYSPRINT 70 
system allocation 3 
system interface 4 



task global variable 27 
task variable 10 
TESTRCMD command list 
TESTSP command list 74 
tilde definition 26 
transaction program 

command processor 4 

user exit 4 
TSO 49 
TUTOR command 44 

U 

UNIQUE command 14, 20 
UPPER command 19 
user exit interface 2, 4 
user interface 

BNJDNUMB 54 

BNJwwwww 55 
user subtask, writing a 4 
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user table, defi 


ning 


BNJ81UTB 


69 


BNJ82UTB 


69 


BNJ92UTB 


69 


BNJ93UTB 


69 


BNJ94UTB 


69 


BNJ95UTB 


69 


BNJ96UTB 


69 


for MVS 69 


for VM 69 




link-editing 




for MVS 


70 


for VM ; 


70 


sample 69 




user-defined alert 


generic 61 




pregeneric 


61 


user-defined load data set 


USERLIB 69 





70 



variable data typing 9 
variable row placement option 59 
VIEW command 4 
VIEW command processor 
attribute definition 14 
coding the 13 
creating a rollable component 

issuing command from command procedure 

using the UNIQUE command 20 

using the UPPER command 19 
definition statement 14 
displaying error message 33 
displaying return code 33 
displaying variables in source panels 17 
dynamic update capability 26 
finding global variable 18 
full-screen input capability 21 
INPUT option 14, 26 
input value 14 

managing the command line 28 
managing the PF key 28 
MSG option 13, 26 
NOINPUT option 14, 26 
NOMSG option 14, 26 
panel definition for use with 

attribute symbol 14 

attribute variable 16 

controlling color 14 

controlling highlighting 14 
refresh contents of panel 13, 26 
return code from 32 
returning command line input 26 
using the 13 
VIEWAID variable 21 
VIEWAID variable 21 
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VPD command 78 
VPDACT command list 76 
VPDALL command 76, 77 
VPDCMD command 75, 76 
VPDDCE command entry 76, 77 
VPDLOG command 75 

external logging facility 75, 76 
VPDLOGC command list 76, 77 
VPDPU command entry 76, 77 
VPDTASK 76 

VPDXDOM command list 76, 77 
VSAM data service 3 
VTAM CNMI 3 

VTAM configuration member in VTAMLST 76, 77 
VTAMLST 76 

Special Characters 

&CGLOBAL 18 
&CUR 26, 37 
&TGLOBAL 18 
&WAIT 78 
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